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Chapter 1 


Multimedia Framework API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.3 Overview 


The Multimedia Framework is designed to provide easy to use services for developing multimedia appli- 
cations based on an embedded Linux platform. 


The Multimedia Framework API reference has defined APIs to support the functions below: 
* Playback of multimedia contents. 
* Controlling volume information. 
* Controlling direction of sound input/output. 
* Recording audio/video stream. 
* Capturing still image. 


* Manipulating image codec. 


The manipulated images are not currently part of the multimedia framework. 


1.2.1 Architecture Design 
The multimedia framework can be divided into three parts: 
* Libraries that provide high-level APIs to multimedia applications 


* Common library for manipulating attributes of each multimedia instance. 


* Media-engine 


2 Multimedia Framework API 


The figure below is a high-level diagram of the multimedia framework. 
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Figure 1.1: Multimedia Architecture 


1.2[.3 Multimedia Framework Libraries 


The Multimedia Framework consists of five libraries to provide high-level APIs for multimedia applica- 
tions. The Attributes library is a common module for manipulating the attributes of each library. The others 
provide functions for doing multimedia tasks. 


1.2.2.1 Player Library 


The Player Library provides various functions for a multimedia application to implement playback of media 
contents. Ап application can play different formats of audio and audio/video files. File formats could 
include MP3, OGG, MP4, ЗОР and others. The Player Library provides a consistent interface for playing 
different formats by hiding the creation/construction of various streaming elements from the application. 
This should make the application coding simpler and faster. 


The Player Library provides functions that play the media, stop play-back, and pause/resume playback. 
An application can seek to any desired location of the media by time, video-frame or percentage of file. 
At the same time, an application can request the current position which can be utilized to implement 
elapsed time display. Application can utilize trick-mode APIs to implement fast-forward & fast-rewind. 
The Player Library also facilitates extraction of metadata information like album name, author, track name 
etc. Controlling the volume is also possible using the Player Library. 
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1.2.2.2 Camcorder Library 


The Camcorder Library provides various functions for multimedia applications to implement recording of 
various media contents. An application can record audio and audio/video into local files. File formats 
could include MP3, AAC, MP4 etc. An application can also capture images into files in JPEG or other 
image formats. 


This library provides a similar interface for audio recording, audio/video recording and image capture. 
The type of encoding to be used for audio, video or image, and the file format can be selected by the 
application. An application can also implement preview while simultaneously recording or capturing the 
image. Image capture could be still-shot or multi-shot where the interval between captures could be defined 
by the application. The library provides all the standard camcorder controls such as white-balance, color- 
tone, optical-filters, day/night mode, flip etc. 


An application can query the display's orientation, get/set scale parameters, and the width/height of the 
display. Similarly, an application can also determine the sound device's capabilities such as sample rate, 
number of audio channels etc. 


1.2.2.5 Sound Library 


The Sound Library provides functions to manage the sound system. An application can increase/decrease 
volume and, mute/unmute using this library. An application can control audio input devices like micro- 
phones, hands-free devices, etc. It can also control audio output devices such as ear-phones, speaker- 
phones, hands-free devices, etc. 


1.2.2.4 Image Library 


The Image Library provides functions to convert images into various formats. An application can read files 
encoded in JPEG, PNG, etc. and convert them into alternate image formats. An application can also obtain 
the decoded raw image data using this library. 


1.2.2.5 Attributes Library 


The Attributes Library provides functions for manipulating the attributes of multimedia handles such as 
player, camcorder, image, etc. Attributes can be of various types such as integer, float, string or data 
(void). An application can use get/set functions to set values for various attributes. For an attribute of 
type integer, the application could also set the range of values that this attribute can assume. For example, 
a player could have a sampling-rate attribute and the application could define specific valid values such as 
22050, 44100, etc. for this attribute. 


1.2.3 How to Use the Multimedia Framework 


Each multimedia function can be manipulated with the handle. The handle is obtained by calling the 
appropriate create function such as MMPlayerCreate for player, MMCamcorderCreate for Camcorder, 
MMImageCreateFromFile for image. These functions each create an instance and return a handle. The 
handle is passed to other APIs to achieve the desired functionality. 


For a player, the sequence of function calls is indicated below: 


* MMPlayerCreate is called to create the handle. 


* MMPlayerRealize realizes the pipeline. 
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e MMPlayerStart starts playing the file set by the user. 

* MMPlayerStop stops the playback. 

* MMPlayerGet/SetVolume sets or returns the current volume level during playback. 
* MMPlayerUnrealize destroys the pipeline. 


* MMPlayerDestroy is called to destroy the handle and clear the memory associated with this handle. 


For camcorder, the following sequence of function calls are used: 


MMcCamcorderCreate is called to create the handle. 


Attributes need to be set for the camcorder depending on the mode in which it to be used. For 
example, when used in audio recording mode, the audio codec will need to be set. 


e MMCamcorderRealize realizes the specific pipeline depending upon the mode of the camcorder: 
image, audio, or video. In the case of image or video mode, a preview pipeline is also created. 


e MMCamcorderStart starts the preview. 


e MMCamcorderCaptureStart is used to capture the image in the case of image mode; MMCamcorder- 
Record is used instead to record audio or video. 


e MMCamcorderUnrealize destroys the pipeline. 


MMcCamcorderDestroy is called to destroy the handle and clear the memory associated with this 
handle. 


For an image, the following API calls can be used: 


* MMImageCreateFromFile decodes the given image file. 


* MMImageEncodeToFile encodes the image to a specified file format. The encoder properties are set 
by the user or default settings will be used. 


* MMImageGetData will provide the image data and size of the image. 
e MMImageSetAttrs is used to set image attributes 
e MMImageGetAttrs is used to determine current image attribute settings 


e MMImageDestroy can destroy the image. 
The volume API functions are: 


е MMSoundSetVolume is used to set the volume of the audio device 
е MMSoundGetVolume is used to retrieve the current volume level. 


е MMSoundSetMute mutes the device. 


Attributes are used to communicate between the framework and the application. For example, passing a 
filename and location from an application to the framework. Attributes are used to set and get properties. 
Attributes can be string, data, integer, or float types. 


Attributes that are necessary for the initialization of the player/camcorder instances are set before the in- 
stance initialization. Changing these attributes after initialization does not have any effect. For example, the 
codec setting to be used for encoding cannot be changed after initialization. The attributes that determine 
the controls or properties of the instance can be changed after initialization. For example, the white-balance 
control of the camcorder. 
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1.3 Industry Standard 


None 


1.4 External API Documents 


None 


1.5 Plug-in Extension Point Interface 


None 


1.6 Other Interfaces 


None 


1.7 Other Notes 


None 


Warning: 


APIs that are in the "Draft" state are subject to evolve with new releases. 
Backward compatibility is not guaranteed until moved to the "Final" state. 
Developers should use APIs in the "draft" state at their own risk. 
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Module Index 


2.1 Modules 


Here is a list of all modules: 


Camcorder RE QTRESSQEESRSSTESMISCIUIITOTIDOIIDESIODUOUMMTUITTITT 13 
АЙТІРМШЕв MPMECP-------———cc а аа ЖОК ШУ ОКА 47 
шарасы: ee ie ee в EO m uo m RN aoe Сөз RO ЛЫ Re ЫБ eS ЫЙ ы mes 58 
Player 4 4% geo gat E с ТОО war dies s eo ba e RUE oe Be dees Aids Sh 66 


Module Index 
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Data Structure Index 


3.1 Data Structures 


Here are the data structures with brief descriptions: 


JMMCanmicorderBlementNàme ................................... 93 
lobor udo Acc eS SESE E Rahs Sa She bee фан 95 
MMPaverVolume т ата 97 
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Data Structure Index 
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File Index 


4. File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
Doxygen) 2 zh ee узук EM A ee ES Shee Eo hae RO ERR 4 
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File Index 
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5.1 Camcorder 


5.1.1 Detailed Description 


This part describes the APIs with repect to Multimedia Camcorder Library. Camcorder Library is for 
recording video from video input device, capturing still image from video input device, and audio 
recording from sound input device. 


Camcorder can be reached by calling functions as shown in the following figure, "State of Camcorder". 


Between each states there is intermediate state, and in this state, any function call which change the 
camcorder state will be failed. 


Recording state and paused state exists when the mode of camcorder is video-capture. In case of 
audio-capture mode, CAPTURING state will be replaced with RECORDING state. 


АП of function which change state of camcorder is asynchronous call. It returns immediately and con- 
firm success of changing state will be notified through message callback function. If state is changed 
successfully, callback function will be received state message of new state, if not it will be received 
error message. 


Note that "None" state could be reached from any state by calling MMCamcoderDestroy 


Following are the attributes which may be set before initialization (MMCamcoderRealize): 
MM CAMCORDER ATTR PROFILE, MM CAMCORDER ATTR AUDIO SOURCE, MM - 
CAMCORDER ATTR VIDEO SOURCE, MM CAMCORDER ATTR AUDIO ENCODER, 
MM CAMCORDER ATTR VIDEO ENCODER, MM. CAMCORDER ATTR IMAGE - 
ENCODER, MM CAMCORDER ATTR CAPTURE, MM CAMCORDER ATTR DISPLAY, 
MM CAMCORDER ATTR TARGET 


Following are the attributes which may be set after initialization: ММ CAMCORDER ATTR FILTER 
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MMCamcorderCreateQ) MMCamcorderDestroy() 


MMCamcorderRealized MMCamcorderUnrealize() 


MMCamcorderStart MMCamcorderStopQ 


Prepare 


MMCamcorderCaptureStartd 


MMCamcorderCaptureSto 


AMCamcorderRecord) 


Auto return after captur 


Capturing Recording Paused 
MMCamcorderPause(Q 


MMCamcorderRecord(Q 


Figure 5.1: States of Camcorder 


Function state table. 
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FUNCTION PRE-STATE POST-STATE SYNC TYPE 
MMcCamcorder- NONE NULL SYNC 
Create() 

MMcCamcorder- NULL NONE SYNC 
Destroy() 

MMcCamcorder- NULL READY ASYNC 
Realize() 

MMcCamcorder- READY NULL ASYNC 
Unrealize() 

MMcCamcorderStart() | READY PREPARED ASYNC 
MMcCamcorderStop() | PREPARED READY ASYNC 
MMcCamcorder- PREPARED CAPTURING ASYNC 
CaptureStart() 

MMcCamcorder- CAPTURING PREPARED ASYNC 
CaptureStop() 

MMcCamcorder- PRE- RECORDING ASYNC 
Record() PARED/PAUSED 

MMcCamcorder- RECORDING PAUSED ASYNC 
Pause() 

MMcCamcorder- RECORD- PREPARED ASYNC 
Commit() ING/PAUSED 

MMcCamcorder- RECORD- PREPARED ASYNC 
Cancel() ING/PAUSED 

MMcCamcorderSet- N/A N/A SYNC 
MessageCallback() 

MMcCamcorderGet- N/A N/A SYNC 
State() 

MMcCamcorderFlash- | N/A N/A SYNC 
Оп() 

MMcCamcorderGet- N/A N/A SYNC 
Attrs() 

MMcCamcorderSet- N/A N/A SYNC 
Attrs() 


The table below is attribute lists for camcorder. 
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PROPERTY TYPE VALID TYPE CATEGORY 
file-format int Array Profile 
mode int Array 
audio-device int Range 
video-device int Range 
audio-encoder int Array 
video-encoder int Array 
image-encoder int Array 
samplerate int Array Audio Source 
channel int Range 
format int Range 
width int Range Video Source 
height int Range 
pixel-format int Range 
fps int Range 
bitrate int Range Audio Encoder 
bitrate int Range Video Encoder 
quality int Range Image Encoder 
optical-zoom int Range Filter 
digital-zoom int Range 
brightness int Range 
contrast int Range 
whitebalance int Range 
colortone int Range 
programmode int Range 
flip int Range 
count int Range Capture 
interval int Range 
width int Array 
height int Array 
device int Range Display 
X int Range 
y int Range 
width int Range 
height int Range 
scale int Array 
rotation int Array 
filename string N/A Target 
storage int Array 
Enumerations 
e enum MMCamcorderStateType { 
MM CAMCORDER STATE NULL, MM CAMCORDER STATE READY, MM - 


CAMCORDER STATE PREPARE, MM CAMCORDER STATE CAPTURING, 
MM CAMCORDER STATE RECORDING, ММ CAMCORDER STATE PAUSED, ММ - 


CAMCORDER STATE NUM, MM CAMCORDER STATE NULL, 
MM CAMCORDER STATE READY, 


MM CAMCORDER STATE PREPARE, MM - 


CAMCORDER STATE CAPTURING, ММ CAMCORDER STATE RECORDING, 
ММ CAMCORDER STATE PAUSED, MM CAMCORDER STATE NUM } 
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enum MMCamcorderAttrsType { 


MM CAMCORDER ATTR PROFILE, MM CAMCORDER ATTR AUDIO SOURCE, MM - 
CAMCORDER ATTR VIDEO SOURCE, MM CAMCORDER ATTR AUDIO ENCODER, 


MM CAMCORDER ATTR VIDEO ENCODER, MM. CAMCORDER ATTR IMAGE - 
ENCODER, ММ CAMCORDER ATTR FILTER, MM CAMCORDER ATTR CAPTURE, 


MM CAMCORDER ATTR DISPLAY, MM. CAMCORDER ATTR TARGET, MM - 
CAMCORDER ATTR. NUM, MM CAMCORDER ATTR PROFILE, 


MM CAMCORDER ATTR AUDIO SOURCE, MM CAMCORDER ATTR VIDEO - 
SOURCE, MM CAMCORDER ATTR AUDIO ENCODER, MM CAMCORDER ATTR - 
VIDEO ENCODER, 


MM CAMCORDER ATTR IMAGE ENCODER, MM CAMCORDER ATTR FILTER, MM - 
CAMCORDER АТТК CAPTURE, ММ CAMCORDER ATTR DISPLAY, 


MM CAMCORDER ATTR TARGET, MM CAMCORDER ATTR NUM } 
enum MMCamcorderModeType { 


MM CAMCORDER MODE IMAGE, MM. CAMCORDER MODE AUDIO, MM - 
CAMCORDER MODE VIDEO, ММ CAMCORDER MODE IMAGE, 


ММ CAMCORDER, MODE AUDIO, MM, CAMCORDER MODE VIDEO } 
enum MMCamcorderProfileAttrsID { 


MM CAMCORDER PROFILE MODE, MM CAMCORDER PROFILE AUDIO DEVICE, 
MM CAMCORDER PROFILE VIDEO DEVICE, MM CAMCORDER PROFILE AUDIO - 
CODEC, 


MM CAMCORDER PROFILE VIDEO CODEC, ММ CAMCORDER PROFILE IMAGE - 
CODEC, MM CAMCORDER PROFILE FILE FORMAT, MM CAMCORDER PROFILE - 
NUM, 


MM CAMCORDER PROFILE MODE, MM CAMCORDER PROFILE AUDIO DEVICE, 
MM. CAMCORDER PROFILE VIDEO DEVICE, MM CAMCORDER PROFILE AUDIO - 
CODEC, 


ММ CAMCORDER PROFILE VIDEO CODEC, ММ CAMCORDER PROFILE IMAGE - 
CODEC, MM  CAMCORDER PROFILE FILE FORMAT, MM, CAMCORDER PROFILE - 
NUM } 

enum MMCamcorderAudioSourceAttrsID { 


MM CAMCORDER AUDIO SOURCE SAMPLERATE, ММ CAMCORDER AUDIO - 
SOURCE FORMAT, MM. CAMCORDER AUDIO SOURCE CHANNEL, MM - 
CAMCORDER AUDIO SOURCE NUM, 


MM, CAMCORDER, AUDIO SOURCE SAMPLERATE, MM. CAMCORDER, AUDIO - 
SOURCE FORMAT, MM. CAMCORDER, AUDIO SOURCE CHANNEL, MM - 
CAMCORDER AUDIO SOURCE NUM } 

enum MMCamcorderVideoSourceAttrsID { 


MM CAMCORDER VIDEO SOURCE WIDTH, | MM CAMCORDER VIDEO SOURCE - 
HEIGHT, MM CAMCORDER VIDEO SOURCE FORMAT, MM CAMCORDER VIDEO - 
SOURCE FPS, 


MM CAMCORDER VIDEO SOURCE NUM, MM CAMCORDER VIDEO SOURCE - 
WIDTH, MM CAMCORDER VIDEO SOURCE HEIGHT, MM CAMCORDER VIDEO - 
SOURCE FORMAT, 


ММ CAMCORDER VIDEO SOURCE FPS, MM, CAMCORDER VIDEO SOURCE NUM | 
enum MMCamcorderAudioEncoderAttrsID { ММ CAMCORDER, AUDIO ЕМСОРЕК - 
BITRATE, ММ CAMCORDER, AUDIO ENCODER, NUM, ММ CAMCORDER, AUDIO - 
ENCODER, BITRATE, MM, CAMCORDER, AUDIO ENCODER, NUM } 
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enum MMCamcorderVideoEncoderAttrsID { MM, CAMCORDER VIDEO ENCODER - 
BITRATE, ММ CAMCORDER, VIDEO ENCODER, NUM, MM  CAMCORDER VIDEO - 
ENCODER, BITRATE, MM, CAMCORDER VIDEO ENCODER, NUM } 

enum MMCamcorderImageEncoderAttrsID { ММ CAMCORDER IMAGE ENCODER - 
QUALITY, MM. CAMCORDER, IMAGE ENCODER, NUM, ММ CAMCORDER IMAGE - 
ENCODER, QUALITY, MM, CAMCORDER IMAGE ENCODER, NUM } 

enum MMCamcorderFilterAttrsID { 


MM. CAMCORDER FILTER. BRIGHTNESS, MM CAMCORDER FILTER. CONTRAST, 
MM CAMCORDER FILTER DIGITAL ZOOM, | MM CAMCORDER FILTER OPTICAL - 
ZOOM, 


MM CAMCORDER FILTER WHITE BALANCE, ММ CAMCORDER FILTER COLOR - 
TONE, MM CAMCORDER FILTER PROGRAM MODE, ММ CAMCORDER FILTER - 
FLIP, 


MM CAMCORDER FILTER NUM, MM CAMCORDER FILTER BRIGHTNESS, MM - 
CAMCORDER FILTER. CONTRAST, ММ CAMCORDER FILTER. DIGITAL ZOOM, 

MM CAMCORDER FILTER OPTICAL ZOOM, MM. CAMCORDER FILTER. WHITE - 
BALANCE, MM CAMCORDER FILTER COLOR TONE, MM CAMCORDER FILTER - 
PROGRAM MODE, 

MM CAMCORDER FILTER FLIP, ММ CAMCORDER FILTER NUM } 

enum MMCamcorderWhiteBalanceType ( 

MM CAMCORDER WHITE BALANCE NONE, MM CAMCORDER WHITE BALANCE - 
AUTOMATIC, MM CAMCORDER WHITE BALANCE DAYLIGHT, MM CAMCORDER - 
WHITE BALANCE CLOUDY, 

MM CAMCORDER WHITE BALANCE FLUOROSCENT, ММ CAMCORDER WHITE - 
BALANCE INCANDESCENT, MM CAMCORDER WHITE BALANCE NUM, MM - 
CAMCORDER WHITE BALANCE NONE, 

MM CAMCORDER WHITE BALANCE AUTOMATIC, MM CAMCORDER WHITE - 
BALANCE DAYLIGHT, MM CAMCORDER WHITE BALANCE CLOUDY, MM - 
CAMCORDER WHITE BALANCE FLUOROSCENT, 

MM CAMCORDER WHITE BALANCE INCANDESCENT, MM CAMCORDER WHITE - 
BALANCE NUM } 

enum MMCamcorderColorToneType { 


MM CAMCORDER COLOR TONE NONE, MM CAMCORDER COLOR TONE MONO, 


MM CAMCORDER COLOR TONE SEPIA, MM. CAMCORDER COLOR TONE - 
NEGATIVE, 

MM CAMCORDER COLOR TONE BLUE, MM CAMCORDER COLOR TONE VIOLET, 
MM CAMCORDER COLOR TONE GREEN, MM. CAMCORDER COLOR TONE - 
ORANGE, 


MM CAMCORDER COLOR TONE NUM, MM. CAMCORDER COLOR TONE NONE, 
MM. CAMCORDER COLOR TONE MONO, MM CAMCORDER COLOR TONE SEPIA, 


MM CAMCORDER COLOR TONE NEGATIVE, MM. CAMCORDER COLOR TONE - 
BLUE, ММ CAMCORDER COLOR TONE VIOLET, ММ CAMCORDER COLOR TONE - 
GREEN, 


MM CAMCORDER COLOR TONE ORANGE, ММ CAMCORDER COLOR TONE NUM } 
enum MMCamcorderProgramModeType { 


MM CAMCORDER PROGRAM MODE NONE, MM CAMCORDER PROGRAM MODE - 
NIGHT, MM. CAMCORDER PROGRAM MODE DAYLIGHT, MM. CAMCORDER - 
PROGRAM MODE BACKLIGHT, 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.1 Camcorder 19 


MM CAMCORDER PROGRAM MODE NUM, MM CAMCORDER PROGRAM MODE - 
NONE, MM CAMCORDER PROGRAM MODE NIGHT, MM CAMCORDER PROGRAM - 
MODE DAYLIGHT, 

MM CAMCORDER PROGRAM MODE BACKLIGHT, MM CAMCORDER PROGRAM - 
MODE NUM } 

enum MMCamcorderFlipType { MM. CAMCORDER FLIP HORZ, MM CAMCORDER FLIP - 
VERT, MM. CAMCORDER FLIP. HORZ, ММ CAMCORDER FLIP VERT } 

enum MMCamcorderCaptureAttrsID { 

MM CAMCORDER CAPTURE WIDTH, MM CAMCORDER CAPTURE HEIGHT, MM - 
CAMCORDER CAPTURE COUNT, MM CAMCORDER CAPTURE INTERVAL, 

MM CAMCORDER CAPTURE NUM, MM CAMCORDER CAPTURE WIDTH, ММ- 
CAMCORDER CAPTURE HEIGHT, MM CAMCORDER CAPTURE COUNT, 

MM CAMCORDER CAPTURE INTERVAL, MM CAMCORDER CAPTURE NUM ] 

enum MMCamcorderDisplayAttrsID { 

MM. CAMCORDER DISPLAY DEVICE, MM CAMCORDER DISPLAY X, MM - 
CAMCORDER DISPLAY Ү, ММ CAMCORDER DISPLAY WIDTH, 
ММ CAMCORDER DISPLAY HEIGHT, ММ CAMCORDER DISPLAY SCALE, MM - 
CAMCORDER DISPLAY ROTATION, MM CAMCORDER DISPLAY NUM, 
MM CAMCORDER DISPLAY DEVICE, MM CAMCORDER DISPLAY X, MM - 
CAMCORDER DISPLAY Ү, ММ CAMCORDER DISPLAY WIDTH, 
MM CAMCORDER DISPLAY HEIGHT, ММ CAMCORDER DISPLAY SCALE, MM - 
CAMCORDER DISPLAY ROTATION, MM CAMCORDER DISPLAY NUM } 

enum MMCamcorderTargetAttrsID { 

MM CAMCORDER TARGET STORAGE, MM. CAMCORDER TARGET FILENAME, 
MM CAMCORDER TARGET NUM, MM CAMCORDER TARGET STORAGE, 

MM CAMCORDER TARGET FILENAME, ММ CAMCORDER TARGET NUM } 

enum MMCamcorderStateType { 

MM CAMCORDER STATE NULL, MM CAMCORDER STATE READY, MM - 
AMCORDER STATE PREPARE, MM CAMCORDER STATE CAPTURING, 


C 

MM CAMCORDER STATE RECORDING, ММ CAMCORDER STATE PAUSED, MM - 
CAMCORDER STATE NUM, MM CAMCORDER STATE NULL, 
de 


MM CAMCORDER STATE READY, MM CAMCORDER STATE PREPARE, MM - 
AMCORDER STATE CAPTURING, MM CAMCORDER STATE RECORDING, 


MM CAMCORDER STATE PAUSED, ММ CAMCORDER STATE NUM } 

enum MMCamcorderAttrsType { 

MM CAMCORDER ATTR PROFILE, MM CAMCORDER ATTR AUDIO SOURCE, MM - 
CAMCORDER ATTR VIDEO SOURCE, MM CAMCORDER ATTR AUDIO ENCODER, 
MM CAMCORDER ATTR VIDEO ENCODER, MM. CAMCORDER ATTR IMAGE - 
ENCODER, ММ CAMCORDER ATTR FILTER, MM CAMCORDER ATTR CAPTURE, 

MM CAMCORDER ATTR DISPLAY, ММ CAMCORDER ATTR TARGET, MM - 
CAMCORDER ATTR. NUM, MM  CAMCORDER ATTR PROFILE, 


MM CAMCORDER ATTR AUDIO SOURCE, MM CAMCORDER ATTR VIDEO - 
SOURCE, MM CAMCORDER ATTR AUDIO ENCODER, MM CAMCORDER ATTR - 
VIDEO ENCODER, 


MM CAMCORDER ATTR IMAGE ENCODER, MM CAMCORDER ATTR FILTER, MM - 
CAMCORDER АТТК CAPTURE, ММ CAMCORDER ATTR DISPLAY, 


MM CAMCORDER ATTR TARGET, ММ CAMCORDER ATTR NUM } 
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enum MMCamcorderModeType { 


MM CAMCORDER MODE IMAGE, MM. CAMCORDER MODE AUDIO, MM - 
CAMCORDER MODE VIDEO, ММ CAMCORDER MODE IMAGE, 


ММ CAMCORDER, MODE AUDIO, ММ CAMCORDER MODE VIDEO } 
enum MMCamcorderProfileAttrsID { 


MM CAMCORDER PROFILE MODE, MM CAMCORDER PROFILE AUDIO DEVICE, 
MM CAMCORDER PROFILE VIDEO DEVICE, MM CAMCORDER PROFILE AUDIO - 
CODEC, 


MM CAMCORDER PROFILE VIDEO CODEC, ММ CAMCORDER PROFILE IMAGE - 
CODEC, MM CAMCORDER PROFILE FILE FORMAT, MM CAMCORDER PROFILE - 
NUM, 


MM CAMCORDER PROFILE MODE, MM CAMCORDER PROFILE AUDIO DEVICE, 
MM CAMCORDER PROFILE VIDEO DEVICE, MM CAMCORDER PROFILE AUDIO - 
CODEC, 


ММ CAMCORDER PROFILE VIDEO CODEC, ММ CAMCORDER PROFILE IMAGE - 
CODEC, MM CAMCORDER PROFILE FILE FORMAT, ММ CAMCORDER PROFILE - 
NUM } 

enum MMCamcorderAudioSourceAttrsID { 


MM CAMCORDER AUDIO SOURCE SAMPLERATE, MM. CAMCORDER AUDIO - 
SOURCE FORMAT, ММ CAMCORDER AUDIO SOURCE CHANNEL, MM - 
CAMCORDER AUDIO SOURCE NUM, 


ММ CAMCORDER, AUDIO SOURCE SAMPLERATE, MM. CAMCORDER, AUDIO - 
SOURCE FORMAT, MM. CAMCORDER, AUDIO SOURCE CHANNEL, MM - 
CAMCORDER, AUDIO SOURCE NUM } 

enum MMCamcorderVideoSourceAttrsID { 


MM CAMCORDER VIDEO SOURCE WIDTH, | MM CAMCORDER VIDEO SOURCE - 
HEIGHT, MM CAMCORDER VIDEO SOURCE FORMAT, MM CAMCORDER VIDEO - 
SOURCE FPS, 


MM CAMCORDER VIDEO SOURCE NUM, MM CAMCORDER VIDEO SOURCE - 
WIDTH, MM CAMCORDER VIDEO SOURCE HEIGHT, MM CAMCORDER VIDEO - 
SOURCE FORMAT, 


MM, CAMCORDER VIDEO SOURCE FPS, MM, CAMCORDER VIDEO SOURCE NUM } 
enum MMCamcorderAudioEncoderAttrsID { ММ CAMCORDER, AUDIO ENCODER - 
BITRATE, ММ CAMCORDER, AUDIO ENCODER, NUM, ММ CAMCORDER, AUDIO - 
ENCODER, BITRATE, MM, CAMCORDER, AUDIO ENCODER, NUM } 
enum MMCamcorderVideoEncoderAttrsID { MM, CAMCORDER VIDEO ЕМСОРЕК - 
BITRATE, ММ CAMCORDER, VIDEO ENCODER, NUM, ММ CAMCORDER VIDEO - 
ENCODER, BITRATE, MM, CAMCORDER VIDEO ENCODER, NUM } 
enum MMCamcorderImageEncoderAttrsID { ММ CAMCORDER IMAGE ENCODER - 
QUALITY, ММ CAMCORDER IMAGE ENCODER, NUM, ММ CAMCORDER IMAGE - 
ENCODER QUALITY, ММ CAMCORDER IMAGE ENCODER, NUM } 

enum MMCamcorderFilterAttrsID { 


MM CAMCORDER FILTER. BRIGHTNESS, MM CAMCORDER FILTER. CONTRAST, 
ММ CAMCORDER FILTER DIGITAL ZOOM, ММ CAMCORDER FILTER OPTICAL - 
ZOOM, 


ММ CAMCORDER FILTER WHITE BALANCE, ММ CAMCORDER FILTER COLOR - 
TONE, MM CAMCORDER FILTER PROGRAM MODE, ММ CAMCORDER FILTER - 
FLIP, 
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MM CAMCORDER FILTER NUM, MM CAMCORDER FILTER BRIGHTNESS, MM - 
CAMCORDER FILTER. CONTRAST, ММ CAMCORDER FILTER. DIGITAL ZOOM, 


MM CAMCORDER FILTER OPTICAL ZOOM, MM. CAMCORDER FILTER. WHITE - 
BALANCE, MM CAMCORDER FILTER COLOR TONE, MM CAMCORDER FILTER - 
PROGRAM MODE, 


MM CAMCORDER FILTER FLIP, ММ CAMCORDER FILTER NUM } 

enum MMCamcorderWhiteBalanceType { 

MM. CAMCORDER WHITE BALANCE NONE, MM CAMCORDER WHITE BALANCE - 
AUTOMATIC, MM CAMCORDER WHITE BALANCE DAYLIGHT, MM CAMCORDER - 
WHITE BALANCE CLOUDY, 

MM CAMCORDER WHITE BALANCE FLUOROSCENT, ММ CAMCORDER WHITE - 
BALANCE INCANDESCENT, MM CAMCORDER WHITE BALANCE NUM, MM - 
CAMCORDER WHITE BALANCE NONE, 

MM CAMCORDER WHITE BALANCE AUTOMATIC, MM CAMCORDER WHITE - 
BALANCE DAYLIGHT, MM CAMCORDER WHITE BALANCE CLOUDY, MM - 
CAMCORDER WHITE BALANCE FLUOROSCENT, 

MM CAMCORDER WHITE BALANCE INCANDESCENT, MM CAMCORDER WHITE - 
BALANCE NUM } 

enum MMCamcorderColorToneType { 


MM CAMCORDER COLOR TONE NONE, MM CAMCORDER COLOR TONE MONO, 
MM CAMCORDER COLOR TONE SEPIA, MM. CAMCORDER COLOR TONE - 
NEGATIVE, 

MM CAMCORDER COLOR TONE BLUE, MM CAMCORDER COLOR TONE VIOLET, 
MM CAMCORDER COLOR TONE GREEN, MM. CAMCORDER COLOR TONE - 
ORANGE, 

MM CAMCORDER COLOR TONE NUM, MM. CAMCORDER COLOR TONE NONE, 
MM CAMCORDER COLOR TONE MONO, MM CAMCORDER COLOR TONE SEPIA, 
MM CAMCORDER COLOR TONE NEGATIVE, MM. CAMCORDER COLOR TONE - 


BLUE, ММ CAMCORDER COLOR TONE VIOLET, ММ CAMCORDER COLOR TONE - 
GREEN, 


MM CAMCORDER COLOR TONE ORANGE, ММ CAMCORDER COLOR TONE NUM } 
enum MMCamcorderProgramModeType { 


MM CAMCORDER PROGRAM MODE NONE, MM CAMCORDER PROGRAM MODE - 
NIGHT, ММ CAMCORDER PROGRAM MODE DAYLIGHT, ММ CAMCORDER - 
PROGRAM MODE BACKLIGHT, 


MM CAMCORDER PROGRAM MODE NUM, MM CAMCORDER PROGRAM MODE - 
NONE, MM CAMCORDER PROGRAM MODE NIGHT, MM CAMCORDER PROGRAM - 
MODE DAYLIGHT, 

MM. CAMCORDER PROGRAM MODE BACKLIGHT, MM CAMCORDER PROGRAM - 
MODE NUM } 

enum MMCamcorderFlipType { MM. CAMCORDER FLIP HORZ, MM CAMCORDER FLIP - 
VERT, MM CAMCORDER FLIP HORZ, MM CAMCORDER FLIP VERT } 

enum MMCamcorderCaptureAttrsID { 

MM CAMCORDER CAPTURE WIDTH, MM CAMCORDER CAPTURE HEIGHT, MM - 
CAMCORDER CAPTURE COUNT, MM CAMCORDER CAPTURE INTERVAL, 


MM CAMCORDER CAPTURE NUM, MM CAMCORDER CAPTURE WIDTH, ММ- 
CAMCORDER CAPTURE HEIGHT, MM CAMCORDER CAPTURE COUNT, 


MM CAMCORDER CAPTURE INTERVAL, MM CAMCORDER CAPTURE NUM ] 
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enum MMCamcorderDisplayAttrsID { 


MM CAMCORDER DISPLAY DEVICE, MM CAMCORDER DISPLAY X, MM - 
CAMCORDER DISPLAY Ү, ММ CAMCORDER DISPLAY WIDTH, 
MM CAMCORDER DISPLAY HEIGHT, ММ CAMCORDER DISPLAY SCALE, MM - 
CAMCORDER DISPLAY ROTATION, MM CAMCORDER DISPLAY NUM, 
MM CAMCORDER DISPLAY DEVICE, MM CAMCORDER DISPLAY X, MM - 
CAMCORDER DISPLAY Y,MM CAMCORDER DISPLAY WIDTH, 


MM CAMCORDER DISPLAY HEIGHT, ММ CAMCORDER DISPLAY SCALE, MM - 
CAMCORDER DISPLAY ROTATION, MM CAMCORDER DISPLAY NUM } 
enum MMCamcorderTargetAttrsID { 


MM. CAMCORDER TARGET STORAGE, MM. CAMCORDER TARGET FILENAME, 
MM CAMCORDER TARGET NUM, ММ CAMCORDER TARGET STORAGE, 


MM CAMCORDER TARGET FILENAME, ММ CAMCORDER TARGET NUM } 


Functions 


int MMCamcorderCreate (MMHandleType жсатсогаег) 

int MMCamcorderDestroy (MMHandleType camcorder) 

int MMCamcorderRealize (MMHandleType camcorder) 

int MMCamcorderUnrealize (MMHandleType camcorder) 

int MMCamcorderStart (MMHandleType camcorder) 

int MMCamcorderStop (MMHandleType camcorder) 

int MMCamcorderCaptureStart (MMHandleType camcorder) 

int MMCamcorderCaptureStop (MMHandleType camcorder) 

int MMCamcorderRecord (MMHandleType camcorder) 

int MMCamcorderPause (MMHandleType camcorder) 

int MMCamcorderCommit (MMHandleType camcorder) 

int MMCamcorderCancel (MMHandleType camcorder) 

int MMCamcorderSetMessageCallback (MMHandleType camcorder, MMMessageCallback call- 
back, void «user data) 

int MMCamcorderGetState (MMHandleType camcorder, MMCamcorderStateType «state) 

int MMCamcorderFlashOn (MMHandleType camcorder, bool flash. on) 

int MMCamcorderGetAttrs (MMHandleType camcorder, MMcCamcorderAttrsType type, 
MMHandleType xattrs) 

int MMCamcorderSetAttrs (MMHandleType camcorder, MMCamcorderAttrsType type, 
MMHandleType attrs) 


5.1.2 Enumeration Type Documentation 


5.1.21 enum MMCamcorderAttrsType 


Enumerations for attribute types. 


Enumerator: 


MM CAMCORDER ATTR PROFILE Basic configuration for camcorder. See MMCamcorder- 


ProfileAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO SOURCE Audio capture device. See MMCamcorderAudio- 


SourceAttrsID for subclassification 
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MM CAMCORDER ATTR VIDEO SOURCE Video capture device. See MMCamcorderVideo- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO ENCODER Audio encoder. See MMCamcorderAudio- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO ENCODER Video encoder. See MMCamcorderVideo- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR IMAGE ENCODER Image encoder. See MMCamcorderlmage- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR FILTER Filter configuration. See MMCamcorderFilterAttrsID for 
subclassification 


MM CAMCORDER ATTR CAPTURE Capture configuration. See MMCamcorderCaptureAttrs- 
ID for subclassification 


MM CAMCORDER ATTR DISPLAY Display device. See MMCamcorderDisplayAttrsID for 
subclassification 


MM CAMCORDER ATTR TARGET Recording target. See MMCamcorderTargetAttrsID for 
subclassification 


MM CAMCORDER ATTR NUM Number of camcorder attribute types 


MM CAMCORDER ATTR PROFILE Basic configuration for camcorder. See MMCamcorder- 
ProfileAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO SOURCE Audio capture device. See MMCamcorderAudio- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO SOURCE Video capture device. See MMCamcorderVideo- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO ENCODER Audio encoder. See MMCamcorderAudio- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO ENCODER Video encoder. See MMCamcorderVideo- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR IMAGE ENCODER Image encoder. See MMCamcorderlmage- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR FILTER Filter configuration. See MMCamcorderFilterAttrsID for 
subclassification 


MM CAMCORDER ATTR CAPTURE Capture configuration. See MMCamocorderCaptureAttrs- 
ID for subclassification 


MM CAMCORDER ATTR DISPLAY Display device. See MMCamcorderDisplayAttrsID for 
subclassification 


MM CAMCORDER ATTR TARGET Recording target. See MMCamcorderTargetAttrsID for 
subclassification 


MM CAMCORDER ATTR NUM Number of camcorder attribute types 


5.1.2.2 enum MMCamcorderAttrsType 
Enumerations for attribute types. 


Enumerator: 


MM CAMCORDER ATTR PROFILE Basic configuration for camcorder. See MMCamcorder- 
ProfileAttrsID for subclassification 
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MM_CAMCORDER_ATTR_AUDIO_SOURCE Audio capture device. See MMCamcorderAudio- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO SOURCE Video capture device. See MMCamcorderVideo- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO ENCODER Audio encoder. See MMCamcorderAudio- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO ENCODER Video encoder. See MMCamcorderVideo- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR IMAGE ENCODER Image encoder. See MMCamcorderlmage- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR FILTER Filter configuration. See MMCamcorderFilterAttrsID for 
subclassification 


MM CAMCORDER ATTR CAPTURE Capture configuration. See MMCamocorderCaptureAttrs- 
ID for subclassification 


MM CAMCORDER ATTR DISPLAY Display device. See MMCamcorderDisplayAttrsID for 
subclassification 


MM CAMCORDER ATTR TARGET Recording target. See MMCamcorderTargetAttrsID for 
subclassification 


MM CAMCORDER ATTR NUM Number of camcorder attribute types 


MM CAMCORDER ATTR PROFILE Basic configuration for camcorder. See MMCamcorder- 
ProfileAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO SOURCE Audio capture device. See MMCamcorderAudio- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO SOURCE Video capture device. See MMCamcorderVideo- 
SourceAttrsID for subclassification 


MM CAMCORDER ATTR AUDIO ENCODER Audio encoder. See MMCamcorderAudio- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR VIDEO ENCODER Video encoder. See MMCamcorderVideo- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR IMAGE ENCODER Image encoder. See MMCamcorderlmage- 
EncoderAttrsID for subclassification 


MM CAMCORDER ATTR FILTER Filter configuration. See MMCamcorderFilterAttrsID for 
subclassification 


MM CAMCORDER ATTR CAPTURE Capture configuration. See MMCamcorderCaptureAttrs- 
ID for subclassification 


MM CAMCORDER ATTR DISPLAY Display device. See MMCamcorderDisplayAttrsID for 
subclassification 


MM CAMCORDER ATTR TARGET Recording target. See MMCamcorderTargetAttrsID for 
subclassification 


MM CAMCORDER ATTR NUM Number of camcorder attribute types 


5.1.2.3 enum MMCamcorderAudioEncoderAttrsID 


Enumerations for audio encoder attributes 
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Enumerator: 


MM CAMCORDER AUDIO ENCODER BITRATE  Bit-rate of audio encoding. This is an inte- 
ger field 


MM CAMCORDER AUDIO ENCODER NUM Number of audio encoder attributes 


MM CAMCORDER AUDIO ENCODER BITRATE Bit-rate of audio encoding. This is an inte- 
ger field 


MM CAMCORDER AUDIO ENCODER NUM Number of audio encoder attributes 


5.1.2.4 enum MMCamcorderAudioEncoderAttrsID 


Enumerations for audio encoder attributes 


Enumerator: 


MM CAMCORDER AUDIO ENCODER BITRATE  Bit-rate of audio encoding. This is an inte- 
ger field 


MM CAMCORDER AUDIO ENCODER NUM Number of audio encoder attributes 


MM CAMCORDER AUDIO ENCODER BITRATE  Bit-rate of audio encoding. This is an inte- 
ger field 


MM CAMCORDER AUDIO ENCODER NUM Number of audio encoder attributes 


5.1.2.5 enum MMCamcorderAudioSourceA ttrsID 


Enumerations for audio source attributes 


Enumerator: 


MM CAMCORDER AUDIO SOURCE SAMPLERATE Sampling rate of audio stream. This is 
an integer field 


MM CAMCORDER AUDIO SOURCE FORMAT Byte widths of each samples. This is an inte- 
ger field 


MM CAMCORDER AUDIO SOURCE CHANNEL Channels of each samples. This is an integer 
field 


MM CAMCORDER AUDIO SOURCE NUM Number of audio source attributes 


MM CAMCORDER AUDIO SOURCE SAMPLERATE Sampling rate of audio stream. This is 
an integer field 


MM CAMCORDER AUDIO SOURCE FORMAT Byte widths of each samples. This is an inte- 
ger field 


MM CAMCORDER AUDIO SOURCE CHANNEL Channels of each samples. This is an integer 
field 


MM CAMCORDER AUDIO SOURCE NUM Number of audio source attributes 


5.1.2.6 enum MMCampcorderAudioSourceA ttrsID 


Enumerations for audio source attributes 
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Enumerator: 


MM CAMCORDER AUDIO SOURCE SAMPLERATE Sampling rate of audio stream. This is 
an integer field 


MM CAMCORDER AUDIO SOURCE FORMAT Byte widths of each samples. This is an inte- 
ger field 


MM CAMCORDER AUDIO SOURCE CHANNEL Channels of each samples. This is an integer 
field 


MM CAMCORDER AUDIO SOURCE NUM Number of audio source attributes 


MM CAMCORDER AUDIO SOURCE SAMPLERATE Sampling rate of audio stream. This is 
an integer field 


MM CAMCORDER AUDIO SOURCE FORMAT Byte widths of each samples. This is an inte- 
ger field 


MM CAMCORDER AUDIO SOURCE CHANNEL Channels of each samples. This is an integer 
field 


MM CAMCORDER AUDIO SOURCE NUM Number of audio source attributes 


5.1.2.7 enum MMCamcorderCaptureA ttrsID 
Enumerations for still image capture attribute ID. 


Enumerator: 


MM CAMCORDER CAPTURE WIDTH Width of image to capture. This is an integer field 
MM CAMCORDER CAPTURE HEIGHT Height of image to capture. This is an integer field 
MM CAMCORDER CAPTURE COUNT Number of count to capture. This is an integer field 


MM CAMCORDER CAPTURE INTERVAL Interval between capturing images (mili-seconds). 
This is an integer field 


MM CAMCORDER CAPTURE NUM Number of capture attributes 

MM CAMCORDER CAPTURE WIDTH Width of image to capture. This is an integer field 
MM CAMCORDER CAPTURE HEIGHT Height of image to capture. This is an integer field 
MM CAMCORDER CAPTURE COUNT Number of count to capture. This is an integer field 


MM CAMCORDER CAPTURE INTERVAL Interval between capturing images (mili-seconds). 
This is an integer field 


MM CAMCORDER CAPTURE NUM Number of capture attributes 


5.1.2.8 enum MMCamcorderCaptureA ttrsID 
Enumerations for still image capture attribute ID. 


Enumerator: 


MM CAMCORDER CAPTURE WIDTH Width of image to capture. This is an integer field 
MM CAMCORDER CAPTURE HEIGHT Height of image to capture. This is an integer field 
MM CAMCORDER CAPTURE COUNT Number of count to capture. This is an integer field 


MM CAMCORDER CAPTURE INTERVAL Interval between capturing images (mili-seconds). 
This is an integer field 
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MM CAMCORDER CAPTURE NUM Number of capture attributes 

MM CAMCORDER CAPTURE WIDTH Width of image to capture. This is an integer field 
MM CAMCORDER CAPTURE HEIGHT Height of image to capture. This is an integer field 
MM CAMCORDER CAPTURE COUNT Number of count to capture. This is an integer field 


MM CAMCORDER CAPTURE INTERVAL Interval between capturing images (mili-seconds). 
This is an integer field 


MM CAMCORDER CAPTURE NUM Number of capture attributes 


5.1.2.9 enum MMCamcorderColorToneType 
Enumerations for color tone. Color tone provides an impression of seeing through a tinted glass. 


Enumerator: 


MM CAMCORDER COLOR TONE NONE None 

MM CAMCORDER COLOR TONE MONO Mono 

MM CAMCORDER COLOR TONE SEPIA Sepia 

MM CAMCORDER COLOR TONE NEGATIVE Negative 

MM CAMCORDER COLOR TONE BLUE Blue 

MM CAMCORDER COLOR TONE VIOLET Violet 

MM CAMCORDER COLOR TONE GREEN Green 

MM CAMCORDER COLOR TONE ORANGE Orange 

MM CAMCORDER COLOR TONE NUM Number of colour-tone modes 
MM CAMCORDER COLOR TONE NONE None 

MM CAMCORDER COLOR TONE MONO Mono 

MM CAMCORDER COLOR TONE SEPIA Sepia 

MM CAMCORDER COLOR TONE NEGATIVE Negative 

MM CAMCORDER COLOR TONE BLUE Blue 

MM CAMCORDER COLOR TONE VIOLET Violet 

MM CAMCORDER COLOR TONE GREEN Green 

MM CAMCORDER COLOR TONE ORANGE Orange 

MM CAMCORDER COLOR TONE NUM Number of colour-tone modes 


5.1.2.10 enum MMCamcorderColorToneType 
Enumerations for color tone. Color tone provides an impression of seeing through a tinted glass. 


Enumerator: 


MM CAMCORDER COLOR TONE NONE None 

MM CAMCORDER COLOR TONE MONO Mono 

MM CAMCORDER COLOR TONE SEPIA Sepia 

MM CAMCORDER COLOR TONE NEGATIVE Negative 
MM CAMCORDER COLOR TONE BLUE Blue 
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MM CAMCORDER COLOR TONE VIOLET Violet 

MM CAMCORDER COLOR TONE GREEN Green 

MM CAMCORDER COLOR TONE ORANGE Orange 

MM CAMCORDER COLOR TONE NUM Number of colour-tone modes 
MM CAMCORDER COLOR TONE NONE None 

MM CAMCORDER COLOR TONE MONO Mono 

MM CAMCORDER COLOR TONE SEPIA Sepia 

MM CAMCORDER COLOR TONE NEGATIVE Negative 

MM CAMCORDER COLOR TONE BLUE Blue 

MM CAMCORDER COLOR TONE VIOLET Violet 

MM CAMCORDER COLOR TONE GREEN Green 

MM CAMCORDER COLOR TONE ORANGE Orange 

MM CAMCORDER COLOR TONE NUM Number of colour-tone modes 


5.1.2.11 enum MMCamcorderDisplayAttrsID 
Enumerations for display attribute ID. 


Enumerator: 


MM CAMCORDER DISPLAY DEVICE Device id of display. See MMDisplayDeviceType for 
possible values 


MM CAMCORDER DISPLAY X X position of display. This is an integer field 
MM CAMCORDER DISPLAY Y Y posotion of display. This is an integer field 
MM CAMCORDER DISPLAY WIDTH Width of display. This is an integer field 
MM CAMCORDER DISPLAY HEIGHT Height of display. This is an integer field 


MM CAMCORDER DISPLAY SCALE Scale of display (fit to width, fit to height, fullscreen, etc). 
See MMDisplayScaleType for possible values 


MM CAMCORDER DISPLAY ROTATION  Roation of display. See MMDisplayRotationType for 
possible values 


MM CAMCORDER DISPLAY NUM Number of display attributes 


MM CAMCORDER DISPLAY DEVICE Device id of display. See MMDisplayDeviceType for 
possible values 


MM CAMCORDER DISPLAY X X position of display. This is an integer field 
MM CAMCORDER DISPLAY Y Y posotion of display. This is an integer field 
MM CAMCORDER DISPLAY WIDTH Width of display. This is an integer field 
MM CAMCORDER DISPLAY HEIGHT Height of display. This is an integer field 


MM CAMCORDER DISPLAY SCALE Scale of display (fit to width, fit to height, fullscreen, etc). 
See MMDisplayScaleType for possible values 


MM CAMCORDER DISPLAY ROTATION  Roation of display. See MMDisplayRotationType for 
possible values 


MM CAMCORDER DISPLAY NUM Number of display attributes 
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5.1.212 enum MMCamcorderDisplayAttrsID 
Enumerations for display attribute ID. 


Enumerator: 


MM CAMCORDER DISPLAY DEVICE Device id of display. See MMDisplayDeviceType for 
possible values 


MM CAMCORDER DISPLAY X X position of display. This is an integer field 
MM CAMCORDER DISPLAY Y Y posotion of display. This is an integer field 
MM CAMCORDER DISPLAY WIDTH Width of display. This is an integer field 
MM CAMCORDER DISPLAY HEIGHT Height of display. This is an integer field 


MM CAMCORDER DISPLAY SCALE Scale of display (fitto width, fit to height, fullscreen, etc). 
See MMDisplayScaleType for possible values 


MM CAMCORDER DISPLAY ROTATION  Roation of display. See MMDisplayRotationType for 
possible values 


MM CAMCORDER DISPLAY NUM Number of display attributes 


MM CAMCORDER DISPLAY DEVICE Device id of display. See MMDisplayDeviceType for 
possible values 


MM CAMCORDER DISPLAY X X position of display. This is an integer field 
MM CAMCORDER DISPLAY Y Y posotion of display. This is an integer field 
MM CAMCORDER DISPLAY WIDTH Width of display. This is an integer field 
MM CAMCORDER DISPLAY HEIGHT Height of display. This is an integer field 


MM CAMCORDER DISPLAY SCALE Scale of display (fit to width, fit to height, fullscreen, etc). 
See MMDisplayScaleType for possible values 


MM CAMCORDER DISPLAY ROTATION  Roation of display. See MMDisplayRotationType for 
possible values 


MM CAMCORDER DISPLAY NUM Number of display attributes 


5.1.213 enum MMCamcorderFilterAttrsID 


Enumerations for effect attributes 


Enumerator: 


MM CAMCORDER FILTER BRIGHTNESS Brightness level. This is an integer field 

MM CAMCORDER FILTER CONTRAST Contrast level. This is an integer field 

MM CAMCORDER FILTER DIGITAL ZOOM Digital zoom level. This is an integer field 
MM CAMCORDER FILTER OPTICAL ZOOM Optical zoom level. This is an integer field 


MM CAMCORDER FILTER WHITE BALANCE Whitebalance. See MMCamcorderWhite- 
BalanceType for possible values 


MM CAMCORDER FILTER COLOR TONE Color tone. See MMCamcorderColorToneType 
for possible values 


MM CAMCORDER FILTER PROGRAM MODE Program mode. See MMCamcorderProgram- 
ModeType for possible values 


MM CAMCORDER FILTER FLIP Flip. See MMCamcorderFlipType for possible values 
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MM CAMCORDER FILTER NUM Number of filter attributes 

MM CAMCORDER FILTER BRIGHTNESS Brightness level. This is an integer field 

MM CAMCORDER FILTER CONTRAST Contrast level. This is an integer field 

MM CAMCORDER FILTER DIGITAL ZOOM Digital zoom level. This is an integer field 
MM CAMCORDER FILTER OPTICAL ZOOM Optical zoom level. This is an integer field 


MM CAMCORDER FILTER WHITE BALANCE Whitebalance. See MMCamcorderWhite- 
BalanceType for possible values 


MM CAMCORDER FILTER COLOR TONE Color tone. See MMCamcorderColorToneType 
for possible values 


MM CAMCORDER FILTER PROGRAM MODE Program mode. See MMCamcorderProgram- 
ModeType for possible values 


MM CAMCORDER FILTER FLIP Flip. See MMCamcorderFlipType for possible values 
MM CAMCORDER FILTER NUM Number of filter attributes 


5.1.2.14 enum MMCamcorderFilterAttrsID 


Enumerations for effect attributes 


Enumerator: 


MM CAMCORDER FILTER BRIGHTNESS Brightness level. This is an integer field 

MM CAMCORDER FILTER CONTRAST Contrast level. This is an integer field 

MM CAMCORDER FILTER DIGITAL ZOOM Digital zoom level. This is an integer field 
MM CAMCORDER FILTER OPTICAL ZOOM Optical zoom level. This is an integer field 


MM CAMCORDER FILTER WHITE BALANCE Whitebalance. See MMCamcorderWhite- 
BalanceType for possible values 


MM CAMCORDER FILTER COLOR TONE Color tone. See MMCamcorderColorToneType 
for possible values 


MM CAMCORDER FILTER PROGRAM MODE Program mode. See MMCamcorderProgram- 
ModeType for possible values 


MM CAMCORDER FILTER FLIP Flip. See MMCamcorderFlipType for possible values 
MM CAMCORDER FILTER NUM Number of filter attributes 

MM CAMCORDER FILTER BRIGHTNESS Brightness level. This is an integer field 

MM CAMCORDER FILTER CONTRAST Contrast level. This is an integer field 

MM CAMCORDER FILTER DIGITAL ZOOM Digital zoom level. This is an integer field 
MM CAMCORDER FILTER OPTICAL ZOOM Optical zoom level. This is an integer field 


MM CAMCORDER FILTER WHITE BALANCE Whitebalance. See MMCamcorderWhite- 
BalanceType for possible values 


MM CAMCORDER FILTER COLOR TONE Color tone. See MMCamcorderColorToneType 
for possible values 


MM CAMCORDER FILTER PROGRAM MODE Program mode. See MMCamcorderProgram- 
ModeType for possible values 


MM CAMCORDER FILTER FLIP Flip. See MMCamcorderFlipType for possible values 
MM CAMCORDER FILTER NUM Number of filter attributes 
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5.1.2.15 enum MMCamcorderFlipType 
Enumerations for flip mode. Flip can be horizontal or vertical. 


Enumerator: 
MM CAMCORDER FLIP HORZ Horizontal 
MM CAMCORDER FLIP VERT Vertical 
MM CAMCORDER FLIP HORZ Horizontal 
MM CAMCORDER FLIP VERT Vertical 


5.1.2.16 enum MMCamcorderFlipType 
Enumerations for flip mode. Flip can be horizontal or vertical. 


Enumerator: 
MM CAMCORDER FLIP HORZ Horizontal 
MM CAMCORDER FLIP VERT Vertical 
MM CAMCORDER FLIP HORZ Horizontal 
MM CAMCORDER FLIP VERT Vertical 


5.1.2.17 enum MMCamcorderImageEncoderAttrsID 
Enumerations for image encoder attributes 


Enumerator: 
MM CAMCORDER IMAGE ENCODER QUALITY Quality of image encoding. This is an inte- 
ger field 
MM CAMCORDER IMAGE ENCODER NUM Number of image encoder attributes 
MM CAMCORDER IMAGE ENCODER QUALITY Quality of image encoding. This is an inte- 
ger field 
MM CAMCORDER IMAGE ENCODER NUM Number of image encoder attributes 


5.1.2.18 enum MM CamcorderlImageEncoderA ttrsID 
Enumerations for image encoder attributes 


Enumerator: 
MM CAMCORDER IMAGE ENCODER QUALITY Quality of image encoding. This is an inte- 
ger field 
MM CAMCORDER IMAGE ENCODER NUM Number of image encoder attributes 
MM CAMCORDER IMAGE ENCODER QUALITY Quality of image encoding. This is an inte- 
ger field 
MM CAMCORDER IMAGE ENCODER NUM Number of image encoder attributes 
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5.1.2.19 enum MMCamcorderModeType 


Enumerations for camcorder mode. 


Enumerator: 
MM CAMCORDER MODE IMAGE Still image capture mode 
MM CAMCORDER MODE AUDIO Audio recording mode 
MM CAMCORDER MODE VIDEO Video recording mode 
MM CAMCORDER MODE IMAGE Still image capture mode 
MM CAMCORDER MODE AUDIO Audio recording mode 
MM CAMCORDER MODE VIDEO Video recording mode 


5.1.2.20 enum MMCamcorderModeType 


Enumerations for camcorder mode. 


Enumerator: 
MM CAMCORDER MODE IMAGE Still image capture mode 
MM CAMCORDER MODE AUDIO Audio recording mode 
MM CAMCORDER MODE VIDEO Video recording mode 
MM CAMCORDER MODE IMAGE Still image capture mode 
MM CAMCORDER MODE AUDIO Audio recording mode 
MM CAMCORDER MODE VIDEO Video recording mode 


5.1.2.21 enum MMCamcorderProfileA ttrsID 
Enumerations for profile ID. 


Enumerator: 

MM CAMCORDER PROFILE MODE Mode of camcorder .(still/video/audio). See 
MMCamcorderModeType for possible values 

MM CAMCORDER PROFILE AUDIO DEVICE Audio device ID for capturing audio stream. 
See MMAudioDeviceType for possible vlaues 

MM CAMCORDER PROFILE VIDEO DEVICE Video device ID for capturing video stream. 
See MMVideoDeviceType for possible values 

MM CAMCORDER PROFILE AUDIO CODEC Audio codec ID for encoding audio stream. 
See MMAudioCodecType for possible values 

MM CAMCORDER PROFILE VIDEO CODEC Video codec ID for encoding video stream. See 
MMVideoDeviceType for possible values 

MM CAMCORDER PROFILE IMAGE CODEC Image codec ID for capturing still-image. See 
MMlImageCodecType for possible values 

MM CAMCORDER PROFILE FILE FORMAT File format ID for recording media stream. See 
MMfFileFormatType for possible values 


MM CAMCORDER PROFILE NUM Number of profile attributes 
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MM CAMCORDER PROFILE MODE Mode of camcorder (still/video/audio). See 
MMcCamcorderModeType for possible values 


MM CAMCORDER PROFILE AUDIO DEVICE Audio device ID for capturing audio stream. 
See MMAudioDeviceType for possible vlaues 


MM CAMCORDER PROFILE VIDEO DEVICE Video device ID for capturing video stream. 
See MMVideoDeviceType for possible values 


MM CAMCORDER PROFILE AUDIO CODEC Audio codec ID for encoding audio stream. 
See MMAudioCodecType for possible values 


MM CAMCORDER PROFILE VIDEO CODEC Video codec ID for encoding video stream. See 
MMVideoDeviceType for possible values 


MM CAMCORDER PROFILE IMAGE CODEC Image codec ID for capturing still-image. See 
MMlImageCodecType for possible values 


MM CAMCORDER PROFILE FILE FORMAT File format ID for recording media stream. See 
MMfFileFormatType for possible values 


MM CAMCORDER PROFILE NUM Number of profile attributes 


5.1.2.22 enum MMCamcorderProfileAttrsID 
Enumerations for profile ID. 


Enumerator: 
MM CAMCORDER PROFILE MODE Mode of camcorder (still/video/audio). See 
MMCamcorderModeType for possible values 
MM CAMCORDER PROFILE AUDIO DEVICE Audio device ID for capturing audio stream. 
See MMAudioDeviceType for possible vlaues 


MM CAMCORDER PROFILE VIDEO DEVICE Video device ID for capturing video stream. 
See MMVideoDeviceType for possible values 


MM CAMCORDER PROFILE AUDIO CODEC Audio codec ID for encoding audio stream. 
See MMAudioCodecType for possible values 


MM CAMCORDER PROFILE VIDEO CODEC Video codec ID for encoding video stream. See 
MMVideoDeviceType for possible values 


MM CAMCORDER PROFILE IMAGE CODEC Image codec ID for capturing still-image. See 
MMlImageCodecType for possible values 


MM CAMCORDER PROFILE FILE FORMAT File format ID for recording media stream. See 
MMfFileFormatType for possible values 


MM CAMCORDER PROFILE NUM Number of profile attributes 


MM CAMCORDER PROFILE MODE Mode of camcorder .(still/video/audio). See 
MMcCamcorderModeType for possible values 


MM CAMCORDER PROFILE AUDIO DEVICE Audio device ID for capturing audio stream. 
See MMAudioDeviceType for possible vlaues 


MM CAMCORDER PROFILE VIDEO DEVICE Video device ID for capturing video stream. 
See MMVideoDeviceType for possible values 


MM CAMCORDER PROFILE AUDIO CODEC Audio codec ID for encoding audio stream. 
See MMAudioCodecType for possible values 


MM CAMCORDER PROFILE VIDEO CODEC Video codec ID for encoding video stream. See 
MMVideoDeviceType for possible values 
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MM CAMCORDER PROFILE IMAGE CODEC Image codec ID for capturing still-image. See 
MMlImageCodecType for possible values 


MM CAMCORDER PROFILE FILE FORMAT File format ID for recording media stream. See 
MMfFileFormatType for possible values 


MM CAMCORDER PROFILE NUM Number of profile attributes 


5.1.2.23 enum MMCamcorderProgramModeType 


Enumerations for program mode. Program mode gives the environment condition for operating camcorder. 
The mode of operation can be in daylight, night and backlight. It can be a automatic setting also. 


Enumerator: 
MM CAMCORDER PROGRAM MODE NONE None 
MM CAMCORDER PROGRAM MODE NIGHT Night 
MM CAMCORDER PROGRAM MODE DAYLIGHT Daylight 
MM CAMCORDER PROGRAM MODE BACKLIGHT  Backlight 
MM CAMCORDER PROGRAM MODE NUM Number of program-modes 
MM CAMCORDER PROGRAM MODE NONE None 
MM CAMCORDER PROGRAM MODE NIGHT Night 
MM CAMCORDER PROGRAM MODE DAYLIGHT Daylight 
MM CAMCORDER PROGRAM MODE BACKLIGHT  Backlight 
MM CAMCORDER PROGRAM MODE NUM Number of program-modes 


5.1.2.24 enum MMCamcorderProgramModeType 


Enumerations for program mode. Program mode gives the environment condition for operating camcorder. 
The mode of operation can be in daylight, night and backlight. It can be a automatic setting also. 


Enumerator: 
MM CAMCORDER PROGRAM MODE NONE None 
MM CAMCORDER PROGRAM MODE NIGHT Night 
MM CAMCORDER PROGRAM MODE DAYLIGHT Daylight 
MM CAMCORDER PROGRAM MODE BACKLIGHT Backlight 
MM CAMCORDER PROGRAM MODE NUM Number of program-modes 
MM CAMCORDER PROGRAM MODE NONE None 
MM CAMCORDER PROGRAM MODE NIGHT Night 
MM CAMCORDER PROGRAM MODE DAYLIGHT Daylight 
MM CAMCORDER PROGRAM MODE BACKLIGHT  Backlight 
MM CAMCORDER PROGRAM MODE NUM Number of program-modes 
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5.1.2.25 enum MMCamcorderStateType 


Enumerations for camcorder states. 


Enumerator: 
MM CAMCORDER STATE NULL Camcorder is created, but not initialized yet 
MM CAMCORDER STATE READY Camcorder is ready to capture 
MM CAMCORDER STATE PREPARE Camcorder is prepared to capture (Preview) 
MM CAMCORDER STATE CAPTURING Camcorder is now capturing still images 
MM CAMCORDER STATE RECORDING Camcorder is now recording 
MM CAMCORDER STATE PAUSED Camcorder is paused while recording 
MM CAMCORDER STATE NUM Number of camcorder states 
MM CAMCORDER STATE NULL Camcorder is created, but not initialized yet 
MM CAMCORDER STATE READY Camcorder is ready to capture 
MM CAMCORDER STATE PREPARE Camcorder is prepared to capture (Preview) 
MM CAMCORDER STATE CAPTURING Camcorder is now capturing still images 
MM CAMCORDER STATE RECORDING Camcorder is now recording 
MM CAMCORDER STATE PAUSED Camcorder is paused while recording 
MM CAMCORDER STATE NUM Number of camcorder states 


5.1.2.26 enum MMCamcorderStateType 


Enumerations for camcorder states. 


Enumerator: 
MM CAMCORDER STATE NULL Camcorder is created, but not initialized yet 
MM CAMCORDER STATE READY Camcorder is ready to capture 
MM CAMCORDER STATE PREPARE Camcorder is prepared to capture (Preview) 
MM CAMCORDER STATE CAPTURING Camcorder is now capturing still images 
MM CAMCORDER STATE RECORDING Camcorder is now recording 
MM CAMCORDER STATE PAUSED Camcorder is paused while recording 
MM CAMCORDER STATE NUM Number of camcorder states 
MM CAMCORDER STATE NULL Camcorder is created, but not initialized yet 
MM CAMCORDER STATE READY Camcorder is ready to capture 
MM CAMCORDER STATE PREPARE Camcorder is prepared to capture (Preview) 
MM CAMCORDER STATE CAPTURING Camcorder is now capturing still images 
MM CAMCORDER STATE RECORDING Camcorder is now recording 
MM CAMCORDER STATE PAUSED Camcorder is paused while recording 
MM CAMCORDER STATE NUM Number of camcorder states 
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5.1.2.27 enum MM CamcorderTargetA ttrsID 
Enumerations for target attribute ID. 


Enumerator: 


MM CAMCORDER TARGET STORAGE Storage type (Internal/External). See MMStorageType 
for possible values 


MM CAMCORDER TARGET FILENAME Filename to save. This is a string field 
MM CAMCORDER TARGET NUM Number of target attributes 


MM CAMCORDER TARGET STORAGE Storage type (Internal/External). See MMStorageType 
for possible values 


MM CAMCORDER TARGET FILENAME Filename to save. This is a string field 
MM CAMCORDER TARGET NUM Number of target attributes 


5.1.2.28 enum MMCamcorderTargetAttrsID 
Enumerations for target attribute ID. 


Enumerator: 


MM_CAMCORDER_TARGET_STORAGE Storage type (Internal/External). See MMStorageType 
for possible values 


MM_CAMCORDER_TARGET_FILENAME Filename to save. This is a string field 
MM_CAMCORDER_TARGET_NUM Number of target attributes 


MM_CAMCORDER_TARGET_STORAGE Storage type (Internal/External). See MMStorageType 
for possible values 


MM_CAMCORDER_TARGET_FILENAME Filename to save. This is a string field 
MM_CAMCORDER_TARGET_NUM Number of target attributes 


5.1.2.29 enum MMCamcorder VideoEncoderA ttrsID 


Enumerations for video encoder attributes 


Enumerator: 


MM CAMCORDER VIDEO ENCODER BITRATE  Bit-rate of video encoding. This is an inte- 
ger field 


MM CAMCORDER VIDEO ENCODER NUM Number of video encoder attributes 


MM CAMCORDER VIDEO ENCODER BITRATE  Bit-rate of video encoding. This is an inte- 
ger field 


MM CAMCORDER VIDEO ENCODER NUM Number of video encoder attributes 


5.1.2.30 enum MMCamcorderVideoEncoderA ttrsID 


Enumerations for video encoder attributes 
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Enumerator: 


MM CAMCORDER VIDEO ENCODER BITRATE  Bit-rate of video encoding. This is an inte- 
ger field 


MM CAMCORDER VIDEO ENCODER NUM Number of video encoder attributes 


MM CAMCORDER VIDEO ENCODER BITRATE  Bit-rate of video encoding. This is an inte- 
ger field 


MM CAMCORDER VIDEO ENCODER NUM Number of video encoder attributes 


5.1.2.31 enum MM Camcorder VideoSourceAttrsID 


Enumerations for video source attributes 


Enumerator: 


MM CAMCORDER VIDEO SOURCE WIDTH Width of input video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE HEIGHT Height of input video stream. This is an inte- 
ger field 


MM CAMCORDER VIDEO SOURCE FORMAT Format of video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE FPS Frames per second. This is an integer field 
MM CAMCORDER VIDEO SOURCE NUM Number of video source attributes 


MM CAMCORDER VIDEO SOURCE WIDTH Width of input video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE HEIGHT Height of input video stream. This is an inte- 
ger field 


MM CAMCORDER VIDEO SOURCE FORMAT Format of video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE FPS Frames per second. This is an integer field 
MM CAMCORDER VIDEO SOURCE NUM Number of video source attributes 


5.1.2.32 enum MM Camcorder VideoSourceA ttrsID 


Enumerations for video source attributes 


Enumerator: 


MM CAMCORDER VIDEO SOURCE WIDTH Width of input video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE HEIGHT Height of input video stream. This is an inte- 
ger field 


MM CAMCORDER VIDEO SOURCE FORMAT Format of video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE FPS Frames per second. This is an integer field 
MM CAMCORDER VIDEO SOURCE NUM Number of video source attributes 


MM CAMCORDER VIDEO SOURCE WIDTH Width of input video stream. This is an integer 
field 
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MM CAMCORDER VIDEO SOURCE HEIGHT Height of input video stream. This is an inte- 
ger field 


MM CAMCORDER VIDEO SOURCE FORMAT Format of video stream. This is an integer 
field 


MM CAMCORDER VIDEO SOURCE FPS Frames per second. This is an integer field 
MM CAMCORDER VIDEO SOURCE NUM Number of video source attributes 


5.1.2.33 enum MMCamcorderWhiteBalanceType 


Enumerations for white balance. White Balance is the control that adjusts the camcorder's color sensi- 
tivity to match the prevailing color of white outdoor light, yellower indoor light, or (sometimes) greenish 
fluorescent light. White balance may be set either automatically or manually. White balance may be set 
"incorrectly" on purpose to achieve special effects. 


Enumerator: 


MM CAMCORDER WHITE BALANCE NONE None 

MM CAMCORDER WHITE BALANCE AUTOMATIC Automatic 

MM CAMCORDER WHITE BALANCE DAYLIGHT Daylight 

MM CAMCORDER WHITE BALANCE CLOUDY Cloudy 

MM CAMCORDER WHITE BALANCE FLUOROSCENT  Flouroscent 

MM CAMCORDER WHITE BALANCE INCANDESCENT  Incandescent 

MM CAMCORDER WHITE BALANCE NUM Number of WhiteBalance modes 
MM CAMCORDER WHITE BALANCE NONE None 

MM CAMCORDER WHITE BALANCE AUTOMATIC Automatic 

MM CAMCORDER WHITE BALANCE DAYLIGHT Daylight 

MM CAMCORDER WHITE BALANCE CLOUDY Cloudy 

MM CAMCORDER WHITE BALANCE FLUOROSCENT  Flouroscent 

MM CAMCORDER WHITE BALANCE INCANDESCENT  Incandescent 

MM CAMCORDER WHITE BALANCE NUM Number of WhiteBalance modes 


5.1.2.34 enum MMCamcorderWhiteBalanceType 


Enumerations for white balance. White Balance is the control that adjusts the camcorder's color sensi- 
tivity to match the prevailing color of white outdoor light, yellower indoor light, or (sometimes) greenish 
fluorescent light. White balance may be set either automatically or manually. White balance may be set 
"incorrectly" on purpose to achieve special effects. 


Enumerator: 


MM CAMCORDER WHITE BALANCE NONE None 

MM CAMCORDER WHITE BALANCE AUTOMATIC Automatic 

MM CAMCORDER WHITE BALANCE DAYLIGHT Daylight 

MM CAMCORDER WHITE BALANCE CLOUDY Cloudy 

MM CAMCORDER WHITE BALANCE FLUOROSCENT Flouroscent 
MM CAMCORDER WHITE BALANCE INCANDESCENT  Incandescent 
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MM CAMCORDER WHITE BALANCE NUM Number of WhiteBalance modes 
MM CAMCORDER WHITE BALANCE NONE None 

MM CAMCORDER WHITE BALANCE AUTOMATIC Automatic 

MM CAMCORDER WHITE BALANCE DAYLIGHT Daylight 

MM CAMCORDER WHITE BALANCE CLOUDY Cloudy 

MM CAMCORDER WHITE BALANCE FLUOROSCENT Flouroscent 

MM CAMCORDER WHITE BALANCE INCANDESCENT  Incandescent 

MM CAMCORDER WHITE BALANCE NUM Number of WhiteBalance modes 


5.1.3 Function Documentation 
5.1.3.1 int MMCamcorderCancel (MMHandleType camcorder) 


This function is to stop recording and do not save results. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMCamcorderCommit 


Precondition: 


MM CAMCORDER STATE RECORDING or MM CAMCORDER STATE PAUSED 


Postcondition: 


ММ CAMCORDER STATE РКЕРАКЕ 


5.1.3.2 int MMCamcorderCaptureStart (MMHandleType camcorder) 
This function to start capturing of still images. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 
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See also: 


MMCamcorderCaptureStop 


Precondition: 


MM CAMCORDER STATE PREPARE 


Postcondition: 


MM CAMCORDER STATE CAPTURING and auto return to MM CAMCORDER STATE - 
PREPARE 


5.1.33 int MMCamcorderCaptureStop (MMHandleType camcorder) 
This function is to stop capturing still images. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMcCamcorderCaptureStart 


Precondition: 


MM CAMCORDER STATE CAPTURING 


Postcondition: 


MM CAMCORDER STATE РКЕРАКЕ 


5.1.3.4 іш MMCamcorderCommit (MMHandleType camcorder) 
This function is to stop recording and save results. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 
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See also: 


MMcCamcorderCancel 


Precondition: 


MM CAMCORDER STATE RECORDING or MM CAMCORDER STATE PAUSED 


Postcondition: 


MM CAMCORDER STATE PREPARE 


5.1.3.5 int MMCamcorderCreate (MMHandleType х camcorder) 


global functions 


5.1.3.6 int MMCamcorderDestroy (MMHandleType camcorder) 


This function destroys camcorder object. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


This method could be called with a valid camcoder handle from any state to completely shutdown the 
camcoder operation 


See also: 


MMcCamcorderCreate 


Precondition: 


MM CAMCORDER STATE NONE 


Postcondition: 


MM CAMCORDER STATE NULL 


5.1.37 int MMCamcorderFlashOn (MMHandleType camcorder, bool flash on) 


This function is to set display attributes of camcorder. 


Parameters: 


camcorder [in| Handle of camcorder. 


flash on [in] Turn on/off flash. 
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Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


5.1.3.8 int MMCamcorderGetAttrs (MMHandleType camcorder, MMCamcorderAttrsType type, 
MMhHandleType x айт) 


This function is to get the attribute of camcorder with given type. 


Parameters: 


camcorder [in| Handle of camcorder. 
type [in] Attributes type of camcorder. 


attrs [out] On return contains handle to camcoder attributes, or NULL handle 


Returns: 


This function returns zero on success. 


Remarks: 


See also: 


MMcCamcorderSetAttrs 


5.1.3.9 int MMCamcorderGetState (MMHandleType camcorder, MM CamcorderStateType ж 
state) 


This function is to get state of camcorder. 


Parameters: 


camcorder [in| Handle of camcorder. 


state [out] On return contains current state of camcorder 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMCamcorderStateType 
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5.1.3.10 int MMCamcorderPause (MMHandleType camcorder) 


This function is to pause recording. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMCamcorderRecord 


Precondition: 


MM CAMCORDER STATE RECORDING 


Postcondition: 


MM CAMCORDER STATE PREPARE 


5.1.3.11 int MMCamcorderRealize (MMHandleType camcorder) 


This function allocates memory for camcorder and initializes it. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMcCamcorderUnrealize 


Precondition: 


MM CAMCORDER STATE NULL 


Postcondition: 


MM CAMCORDER STATE READY 
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5.1.3.12 int MMCamcorderRecord (MMHandleType camcorder) 


This function is to start recording. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMCamcorderPause 


Precondition: 


MM_CAMCORDER_STATE_PREPARE or MM_CAMCORDER_STATE_PAUSED 


Postcondition: 


MM_CAMCORDER_STATE_RECORDING 


5.1.3.13 int MMCamcorderSetAttrs (MMHandleType camcorder, MMCamcorderAttrsType type, 
MMHandleType айт) 


This function is to set the attribute of camcorder with given type. 
Parameters: 
camcorder [in| Handle of camcorder. 


type [in] Attributes type of camcorder. 


attrs [in] Attributes to set. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMcCamcorderGetAttrs 
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5.1.3.14 int MMCamcorderSetMessageCallback (MMHandleType camcorder, 
MMMessageCallback callback, void х user. data) 


This function is to set callback for receiving messges from camcorder. 


Parameters: 
camcorder [in| Handle of camcorder. 
callback [in] Function pointer of callback function. 


user data [in] User parameter for passing to callback function. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMMessageCallback 


5.1.3.15 int MMCamcorderStart (MMHandleType camcorder) 


This function is to start previewing. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMCamcorderStop 


Precondition: 


MM CAMCORDER STATE READY 


Postcondition: 


MM CAMCORDER STATE PREPARE 
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5.1.3.16 int MMCamcorderStop (MMHandleType camcorder) 


This function is to stop previewing. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMCamcorderStart 


Precondition: 


MM CAMCORDER STATE РКЕРАКЕ 


Postcondition: 


MM CAMCORDER STATE READY 


5.1.3.17 int MMCamcorderUnrealize (MMHandleType camcorder) 


This function uninitializes camcoder and frees allocated memory. 


Parameters: 


camcorder [in| Handle of camcorder. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMcCamcorderRealize 


Precondition: 


MM CAMCORDER STATE READY 


Postcondition: 


MM CAMCORDER STATE NULL 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.2 Attributes 47 


5.2 Attributes 


5.21 Detailed Description 


This part describes APIs of attributes library. This library provides functions for manipulating at- 
tributes of multimedia handles such as player, camcorder, image. Handle of attributes can be retreived 
by calling GetAttrs function of each multimedia handle such as MMPlayerGetAttrs, MMCamcorder- 
GetAttrs, MMImageGetAttrs. This functions returns the handle of attributes which is contained by 
each instance. 


Enumerations 


* enum MMAttrsType { 


MM ATTRS TYPE INVALID = -1, MM ATTRS TYPE INT, MM ATTRS TYPE FLOAT, 
MM ATTRS TYPE STRING, 

MM ATTRS TYPE DATA, MM ATTRS TYPE ARRAY, MM ATTRS TYPE RANGE, MM - 
ATTRS TYPE NUM, 

MM ATTRS TYPE INVALID - -1, MM ATTRS TYPE INT, MM ATTRS TYPE FLOAT, 
MM ATTRS TYPE STRING, 

MM ATTRS TYPE DATA, MM ATTRS TYPE ARRAY, MM ATTRS TYPE RANGE, MM - 
ATTRS TYPE NUM ] 

enum MMAttrsFlag { 

MM ATTRS FLAG NONE = 0, MM ATTRS FLAG READABLE = 1 << 0, MM ATTRS - 
FLAG WRITABLE = 1 << 1, MM ATTRS FLAG MODIFED = 1 << 2, 

MM ATTRS FLAG NONE - 0, MM ATTRS FLAG READABLE - 1 «« 0, MM ATTRS - 
FLAG WRITABLE = 1 << 1, ММ ATTRS FLAG MODIFED-1 << 2 } 

enum MMAttrsType { 

MM ATTRS TYPE INVALID = -1, MM ATTRS TYPE INT, MM ATTRS TYPE FLOAT, 
MM ATTRS TYPE STRING, 

MM ATTRS TYPE DATA, MM ATTRS TYPE ARRAY, MM ATTRS TYPE RANGE, MM - 
ATTRS TYPE NUM, 

MM ATTRS TYPE INVALID = -1, MM ATTRS TYPE INT, MM ATTRS TYPE FLOAT, 
MM ATTRS TYPE STRING, 

MM. ATTRS TYPE DATA, MM ATTRS TYPE ARRAY, MM ATTRS TYPE RANGE, MM - 
ATTRS TYPE NUM } 

enum MMAttrsFlag { 

MM ATTRS FLAG NONE - 0, MM ATTRS FLAG READABLE - 1 «« 0, MM ATTRS - 
FLAG WRITABLE = 1 << 1, MM ATTRS FLAG MODIFED = 1 << 2, 


MM ATTRS FLAG NONE - 0, MM ATTRS FLAG READABLE - 1 «« 0, MM ATTRS - 
FLAG WRITABLE = 1 << 1, MM ATTRS FLAG MODIFED-1 << 2 } 


Functions 


* int MMAttrsGetType (MMHandleType attrs, int id, MMAttrsType xattrtype) 
e int MMAttrsGetFlags (MMHandleType attrs, int id, int flags) 

e int MMAttrsGetValidType (MMHandleType айт, int id, int журе) 

e int MMAttrsGetValidRange (MMHandleType attrs, int id, int «min, int жшах) 
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int MMAttrsGetValidArray (MMHandleType аш, int id, int *count, int **array) 
int MMAttrsSetInt (MMHandleType attrs, int id, int val) 

* int MMAttrsGetInt (MMHandleType attrs, int id, int жуа!) 

* int MMAttrsSetFloat (MMHandleType attrs, int id, float val) 

* int MMAttrsGetFloat (MMHandleType attrs, int id, float «attrval) 

• int MMAttrsSetString (MMHandleType attrs, int id, const char «string, int size) 
e int MMAttrsGetString (MMHandleType attrs, int id, char **sval, int *size) 

* int MMAttrsSetData (MMHandleType attrs, int id, void «data, int size) 

e int MMAttrsGetData (MMHandleType attrs, int id, void «data, int *size) 

* int MMAttrsSetRange (MMHandleType attrs, int id, int min, int max) 

e int MMAttrsGetRange (MMHandleType attrs, int id, int «min, int «max) 

* int MMAttrsSetArray (MMHandleType attrs, int id, int «array, int count) 

int MMAttrsGetArray (MMHandleType attrs, int id, int *«array, int *count) 


5.2.2 Enumeration Type Documentation 
5.2.21 enum MMAttrsFlag 
Enumerations of attribute flags. 


Enumerator: 
MM ATTRS FLAG NONE None flag is set 
MM ATTRS FLAG READABLE  Readable 
MM ATTRS FLAG WRITABLE  Writable 
MM ATTRS FLAG MODIFED Modified 
MM ATTRS FLAG NONE None flag is set 
MM ATTRS FLAG READABLE  Readable 
MM ATTRS FLAG WRITABLE Writable 
MM ATTRS FLAG MODIFED Modified 


5.2.2.2 enum MMAttrsFlag 
Enumerations of attribute flags. 


Enumerator: 
MM ATTRS FLAG NONE None flag is set 
MM ATTRS FLAG READABLE  Readable 
MM ATTRS FLAG WRITABLE Writable 
MM ATTRS FLAG MODIFED Modified 
MM ATTRS FLAG NONE None flag is set 
MM ATTRS FLAG READABLE  Readable 
MM ATTRS FLAG WRITABLE Writable 
MM ATTRS FLAG MODIFED Modified 
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5.2.2.3 enum MMAttrsType 
Enumerations of attribute types. 


Enumerator: 


MM ATTRS TYPE INVALID Туре is invalid 

MM ATTRS TYPE INT Integer type attribute 

MM ATTRS TYPE FLOAT Float type attribute 

MM ATTRS TYPE STRING UTF-8 String type attribute 
MM ATTRS TYPE DATA Pointer type attribute 

MM ATTRS TYPE ARRAY Array type attribute 

MM ATTRS TYPE RANGE Range type attribute 

MM ATTRS TYPE NUM Number of attribute type 

MM ATTRS TYPE INVALID Туре is invalid 

MM ATTRS TYPE INT nteger type attribute 

MM ATTRS TYPE FLOAT Float type attribute 

MM ATTRS TYPE STRING UTF-8 String type attribute 
MM ATTRS TYPE DATA Pointer type attribute 

MM ATTRS TYPE ARRAY Array type attribute 

MM ATTRS TYPE RANGE Range type attribute 

MM ATTRS TYPE NUM Number of attribute type 


5.2.24 enum MMAttrsType 


Enumerations of attribute types. 


Enumerator: 


MM ATTRS TYPE INVALID Туре is invalid 

MM ATTRS TYPE INT Integer type attribute 

MM ATTRS TYPE FLOAT Float type attribute 

MM ATTRS TYPE STRING UTF-8 String type attribute 
MM ATTRS TYPE DATA Pointer type attribute 

MM ATTRS TYPE ARRAY Array type attribute 

MM ATTRS TYPE RANGE Range type attribute 

MM ATTRS TYPE NUM Number of attribute type 

MM ATTRS TYPE INVALID Туре is invalid 

MM ATTRS TYPE INT Integer type attribute 

MM ATTRS TYPE FLOAT Float type attribute 

MM ATTRS TYPE STRING UTF-8 String type attribute 
MM ATTRS TYPE DATA Pointer type attribute 

MM ATTRS TYPE ARRAY Array type attribute 

MM ATTRS TYPE RANGE Range type attribute 

MM ATTRS TYPE NUM Number of attribute type 
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5.2.3 Function Documentation 
5.2.3.1 іш MMAttrsGetArray (MMHandleType attrs, int id, int ** array, int * count) 


This function is to get array of attribute with given id. 


Parameters: 
attrs [in] List of attributes 
id [in] ID of attribute 
array [out] Contains the array of attribute on success, or NULL pointer on failure. 


count [out] Count of array 


Returns: 


This function returns zero on success or negative value on failure. 


Remarks: 


Application would be responsible for managing/releasing the array 


See also: 


MMaAttrsSetArray 


5.2.3.2 int MMAttrsGetData (MMHandleType attrs, int id, void хх data, int х size) 


This function is to get pointer to attribute with given id. 


Parameters: 
attrs [in] List of attributes 
id [in] ID of attribute 
data [out] Placeholder to output data buffer 


size [out] The field contains number of bytes filled in the buffer 


Returns: 


This function returns zero on success or negative value on failure. 


Remarks: 


Application would be responsible for managing/releasing the data 


See also: 


MMaAttrsSetData 
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5.2.3.3 int MMAttrsGetFlags (MMHandleType attrs, int id, int х flags) 
This function is to get flags of attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 


flags [out] On return contains flags of attribute. 


Returns: 


This function MM_MM_ERROR_NONE on success, or negative value with error code. 


Remarks: 


See also: 


MMAttrsFlag 


5.2.3.4 int MMAttrsGetFloat (MMHandleType attrs, int id, float х attrval) 
This function is to get float value to attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 


attrval [out] On return contains float value of attribute on success, or invalid value. 


Returns: 


This function returns zero on success. 


Remarks: 


See also: 


MMaAttrsSetFloat 


5.2.3.5 int MMAttrsGetInt (MMHandleType attrs, int id, int « val) 
This function is to get integer value to attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 


val [out] On return contains integer value of attribute 
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Returns: 


This function returns MM, MM, ERROR NONE on success, or negative value with error code. 


Remarks: 


If type of attributes is not an integer type, the value which is returned by this function is meaningless. 


See also: 


MMAttrsSetInt 


5.2.3.6 int MMAttrsGetRange (MMHandleType айт, int id, int ж min, int ж max) 


This function is to get range of attribute with given id. 


Parameters: 
attrs [in] List of attributes 
id [in] ID of attribute 
min [out] Minimum value of range 
max [out] Maximum value of range 


Returns: 


This function returns zero on success, or negative value. 


Remarks: 


See also: 


MMaAttrsSetRange 


5.2.37 іш MMAttrsGetString (MMHandleType attrs, int id, char хх sval, int х size) 


This function is to get string to attribute with given id. 


Parameters: 
attrs [in] List of attributes 
id [in] ID of attribute 
sval [out] Placeholder to output string buffer 
size [out] The field contains number of characters filled in the buffer 


Returns: 


This function returns zero on success, or negative value on failure. 


Remarks: 


Application would be responsible for managing/releasing the string 


See also: 


MMaAttrsSetString 
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5.2.3.8 int MMAttrsGetType (MMHandleType айт, int id, MMAttrsType х attrtype) 
This function is to retreive type of attribute. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 
attrtype [out] On return contains type of attribute 


Returns: 


This function returns zero. 


Remarks: 


See also: 


MMAttrsType 


5.2.3.9 int MMAttrsGetValidArray (MMHandleType attrs, int id, int х count, int хх array) 
This function is to get valid array of attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 
count [out] Number of array 


array [out] on return contains valid array of attribute 


Returns: 


This function returns MM_MM_ERROR_NONE on success, or negative value with error code. 


Remarks: 


See also: 


5.2.3.10 int MMAttrsGetValidRange (MMHandleType айт, int id, int x min, int х max) 
This function is to get valid range of attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 
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min [out] Minimum value of valid range 
max [out] Maximum value of valid range 


Returns: 


This function returns MM, MM, ERROR NONE on success, or negative value with error code. 


Remarks: 


See also: 


5.2.3.11 int MMAttrsGetValidType (MMHandleType attrs, int id, int * type) 


This function is to get valid value type of attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 
type [out] On return contains valid value type of attribute 


Returns: 


This function returns MM_MM_ERROR_NONE on success, or negative value with error code. 


Remarks: 


See also: 


MMAttrsType 


5.2.3.12 int MMAttrsSetArray (MMHandleType attrs, int id, int х array, int count) 


This function is to set array of attribute with given id. 


Parameters: 


attrs [in] List of attributes 

id [in] ID of attribute 

array |in] Array of integer values 
count [in] Count of array 


Returns: 


This function returns the array of attribute on success, or NULL pointer on failure. 


Remarks: 


See also: 


MMaAttrsGetArray 
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5.2.3.13 int MMAttrsSetData (MMHandleType айт», int id, void ж data, int size) 
This function is to set pointer to attribute with given id. 


Parameters: 


attrs [in] List of attributes 

id [in] ID of attribute 

data [in] Data to set 

size [in] Length of input data 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


Data type is the reference to memory which is allocated by user. The allocated memory must be freed 
by user. 


See also: 


MMaAttrsGetData 


5.2.3.14 int MMAttrsSetFloat (MMHandleType attrs, int id, float val) 
This function is to set float value to attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 


val [in] Integer value to set 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMaAttrsGetFloat 


5.2.3.15 int MMAttrsSetInt (MMHandleType айт», int id, int val) 
This function is to set integer value to attribute with given id. 


Parameters: 


attrs [in] List of attributes 
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id [in] ID of attribute 


val [in] Integer value to set 


Returns: 


This function returns MM, MM, ERROR NONE on success, or negative value with error code. 


Remarks: 


See also: 


MMaAttrsGetInt 


5.2.3.16 int MMAttrsSetRange (MMHandleType айт, int id, int min, int max) 
This function is to set range of attribute with given id. 


Parameters: 


attrs [in] List of attributes 
id [in] ID of attribute 
min [in] Minimum value of range 


max [in] Maximum value of range 


Returns: 


This function returns zero on success, or negative value. 


Remarks: 


See also: 


MMaAttrsGetRange 


5.2.3.17 int MMAttrsSetString (MMHandleType айт, int id, const char х string, int size) 
This function is to set string to attribute with given id. 


Parameters: 


attrs [in] List of attributes 

id [in] ID of attribute 

string [in] String to set 

size [in] Length of string to set 


Returns: 


This function returns zero on success, or negative value with error code. 
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Remarks: 


See also: 


MMaAttrsGetString 
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5.3 


Image 


5.3.1 Detailed Description 


This part describes the APIs with repect to multimedia image library. 


Typedefs 


typedef void ж MMImage 
typedef void ж MMImage 


Enumerations 


enum MMImageColorspace { 


MM IMAGE COLORSPACE RGB, MM IMAGE COLORSPACE YUV 420, MM IMAGE - 
COLORSPACE ҮСУ 422, MM IMAGE COLORSPACE ҮСУ 411, 


MM IMAGE COLORSPACE YUV 444, MM IMAGE COLORSPACE RGB, MM IMAGE - 
COLORSPACE YUV 420, MM IMAGE COLORSPACE YUV 422, 

MM IMAGE COLORSPACE YUV 411, MM IMAGE COLORSPACE YUV 444] 

enum MMImageAttrsType { 


MM IMAGE ATTRS PROFILE, MM IMAGE ATTRS CODEC, MM IMAGE ATTRS NUM, 
MM IMAGE ATTRS PROFILE, 

MM IMAGE ATTRS CODEC, MM IMAGE ATTRS NUM } 

enum MMImageProfileID { 


MM IMAGE PROFILE CODEC, MM IMAGE PROFILE WIDTH, MM IMAGE PROFILE - 
HEIGHT, MM IMAGE PROFILE ROW STRIDE, 


MM IMAGE PROFILE BIT PER SAMPLE, MM IMAGE PROFILE CHANNELS, MM - 
IMAGE PROFILE COLORSPACE, MM IMAGE PROFILE HAS ALPHA, 


MM IMAGE PROFILE PIXEL DATA, ММ IMAGE PROFILE NUM, MM IMAGE - 
PROFILE CODEC, MM IMAGE PROFILE WIDTH, 


MM IMAGE PROFILE HEIGHT, MM IMAGE PROFILE ROW STRIDE, MM IMAGE - 
PROFILE BIT PER. SAMPLE, MM IMAGE PROFILE CHANNELS, 


MM IMAGE PROFILE COLORSPACE, MM IMAGE PROFILE HAS ALPHA, MM - 
IMAGE PROFILE PIXEL DATA, MM IMAGE PROFILE NUM } 


enum MMImageCodecID { ММ IMAGE CODEC QUALITY, MM IMAGE CODEC ID NUM, 
ММ IMAGE CODEC QUALITY, MM IMAGE CODEC ID NUM } 


enum MMImageColorspace { 


MM IMAGE COLORSPACE RGB, MM IMAGE COLORSPACE YUV 420, MM IMAGE - 
COLORSPACE YUV 422, MM IMAGE COLORSPACE YUV 411, 


MM IMAGE COLORSPACE YUV 444, MM IMAGE COLORSPACE RGB, MM IMAGE - 
COLORSPACE YUV 420, MM IMAGE COLORSPACE YUV 422, 


MM IMAGE COLORSPACE YUV 411, MM IMAGE COLORSPACE YUV 444] 
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enum MMImageAttrsType { 


MM IMAGE ATTRS PROFILE, MM IMAGE ATTRS CODEC, MM IMAGE ATTRS NUM, 
MM IMAGE ATTRS PROFILE, 


MM IMAGE ATTRS CODEC, MM IMAGE ATTRS NUM } 
enum MMImageProfileID { 


MM IMAGE PROFILE CODEC, MM IMAGE PROFILE WIDTH, MM IMAGE PROFILE - 
HEIGHT, MM IMAGE PROFILE ROW STRIDE, 


MM IMAGE PROFILE BIT PER SAMPLE, MM IMAGE PROFILE CHANNELS, MM - 
IMAGE PROFILE COLORSPACE, MM IMAGE PROFILE HAS ALPHA, 


MM IMAGE PROFILE PIXEL DATA, ММ IMAGE PROFILE NUM, MM IMAGE - 
PROFILE CODEC, MM IMAGE PROFILE WIDTH, 


MM IMAGE PROFILE HEIGHT, MM IMAGE PROFILE ROW STRIDE, MM IMAGE - 
PROFILE BIT PER. SAMPLE, MM IMAGE PROFILE CHANNELS, 


MM IMAGE PROFILE COLORSPACE, MM IMAGE PROFILE HAS ALPHA, MM - 
IMAGE PROFILE PIXEL DATA, MM IMAGE PROFILE NUM } 

enum MMImageCodecID (ММ IMAGE CODEC QUALITY, ММ IMAGE CODEC ID NUM, 
ММ IMAGE CODEC QUALITY, MM IMAGE CODEC ID NUM } 


Functions 


int MMImageCreateFromFile (MMHandleType «image, const char *filename) 

int MMImageDestroy (MMHandleType image) 

int MMImageEncodeToFile (MMHandleType image, const char *filename) 

int MMImageGetData (MMHandleType image, void жӣаѓа, int *size) 

int MMImageGetAttrs (MMHandleType image, MMImageAttrsType type, MMHandleType xattrs) 
int MMImageSetAttrs (MMHandleType image, MMImageAttrsType type, MMHandleType attrs) 


5.3.2 Typedef Documentation 


5.3.2 


Type 


5.3.2 


Type 


Л typedef void« MMImage 


definition of MMImage 


.2 typedef voids MMImage 


definition of MMImage 


5.3.3 Enumeration Type Documentation 


5.3.3 


Л enum MMImageAttrsType 


Image's attributes 


Enumerator: 


MM IMAGE ATTRS PROFILE Configuration of image. See MMImageProfileID 
MM IMAGE ATTRS CODEC Codec attributes. See MMImageCodecID 
MM IMAGE ATTRS NUM Number of image attributes 
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MM IMAGE ATTRS PROFILE Configuration of image. See MMImageProfileID 
MM IMAGE ATTRS CODEC Codec attributes. See MMImageCodecID 
MM IMAGE ATTRS NUM Number of image attributes 


5.3.3.2 enum MMImageAttrsType 
Image's attributes 


Enumerator: 
MM IMAGE ATTRS PROFILE Configuration of image. See MMImageProfileID 
MM IMAGE ATTRS CODEC Codec attributes. See MMImageCodecID 
MM IMAGE ATTRS NUM Number of image attributes 
MM IMAGE ATTRS PROFILE Configuration of image. See MMImageProfileID 
MM IMAGE ATTRS CODEC Codec attributes. See MMImageCodecID 
MM IMAGE ATTRS NUM Number of image attributes 


5.3.3.3 enum MMImageCodecID 
Image codec's attributes id list 


Enumerator: 


MM IMAGE CODEC QUALITY image quality 
MM IMAGE CODEC ID NUM number of image codec attributes 
MM IMAGE CODEC QUALITY image quality 
MM IMAGE CODEC ID NUM number of image codec attributes 


5.3.3.4 enum MMImageCodecID 
Image codec's attributes id list 


Enumerator: 


MM IMAGE CODEC QUALITY image quality 
MM IMAGE CODEC ID NUM number of image codec attributes 
MM IMAGE CODEC QUALITY image quality 
MM IMAGE CODEC ID NUM number of image codec attributes 


5.3.3.5 enum MMImageColorspace 
Color spaces 


Enumerator: 


MM IMAGE COLORSPACE RGB RGB colorspace 
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MM IMAGE COLORSPACE ҮСУ. 420 YUV420 colorspace 
MM IMAGE COLORSPACE ҮСУ 422 YUV422 colorspace 
MM IMAGE COLORSPACE ҮСУ 411 YUV411 colorspace 
MM IMAGE COLORSPACE ҮСУ 444 YUV444 colorspace 
MM IMAGE COLORSPACE RGB КОВ colorspace 

MM IMAGE COLORSPACE ҮСУ 420 YUV420 colorspace 
MM IMAGE COLORSPACE ҮСУ. 422 YUV422 colorspace 
MM IMAGE COLORSPACE ҮСУ 411 YUV411 colorspace 
MM IMAGE COLORSPACE ҮСУ 444 YUV444 colorspace 


5.3.3.6 enum MMImageColorspace 
Color spaces 


Enumerator: 


MM IMAGE COLORSPACE RGB RGB colorspace 

MM IMAGE COLORSPACE ҮСУ 420 YUV420 colorspace 
MM IMAGE COLORSPACE ҮСУ 422 YUV422 colorspace 
MM IMAGE COLORSPACE ҮСУ 411 YUV411 colorspace 
MM IMAGE COLORSPACE ҮСУ. 444 YUV444 colorspace 
MM IMAGE COLORSPACE RGB КОВ colorspace 

MM IMAGE COLORSPACE ҮСУ 420 YUV420 colorspace 
MM IMAGE COLORSPACE ҮСУ. 422 YUV422 colorspace 
MM IMAGE COLORSPACE ҮСУ 411 YUV411 colorspace 
MM IMAGE COLORSPACE ҮСУ 444 YUV444 colorspace 


5.3.3.7 enum MMImageProfileID 
Image’s attributes id list 


Enumerator: 


MM IMAGE PROFILE CODEC image type. See MMImageCodecType 

MM IMAGE PROFILE WIDTH image width. This is an integer field 

MM IMAGE PROFILE HEIGHT image height. This is an integer field 

MM IMAGE PROFILE ROW STRIDE image row-stride. This is an integer field 

MM IMAGE PROFILE BIT PER SAMPLE image bit-per-sample. This is an integer field 
MM IMAGE PROFILE CHANNELS image number of channels. This is an integer field 
MM IMAGE PROFILE COLORSPACE image colorspace. See MMImageColorspace 
MM IMAGE PROFILE HAS ALPHA image has-alpah channel. This is an integer field 
MM IMAGE PROFILE PIXEL DATA image pixel-data 

MM IMAGE PROFILE NUM number of image profile attributes 

MM IMAGE PROFILE CODEC image type. See MMImageCodecType 
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MM IMAGE PROFILE WIDTH image width. This is an integer field 

MM IMAGE PROFILE HEIGHT image height. This is an integer field 

MM IMAGE PROFILE ROW STRIDE image row-stride. This is an integer field 

MM IMAGE PROFILE BIT PER SAMPLE image bit-per-sample. This is an integer field 
MM IMAGE PROFILE CHANNELS image number of channels. This is an integer field 
MM IMAGE PROFILE COLORSPACE image colorspace. See MMImageColorspace 

MM IMAGE PROFILE HAS ALPHA image has-alpah channel. This is an integer field 
MM IMAGE PROFILE PIXEL DATA image pixel-data 

MM IMAGE PROFILE NUM number of image profile attributes 


5.3.3.8 enum MMImageProfileID 
Image's attributes id list 


Enumerator: 
MM IMAGE PROFILE CODEC image type. See MMImageCodecType 
MM IMAGE PROFILE WIDTH image width. This is an integer field 
MM IMAGE PROFILE HEIGHT image height. This is an integer field 
MM IMAGE PROFILE ROW STRIDE image row-stride. This is an integer field 
MM IMAGE PROFILE BIT PER SAMPLE image bit-per-sample. This is an integer field 
MM IMAGE PROFILE CHANNELS image number of channels. This is an integer field 
MM IMAGE PROFILE COLORSPACE image colorspace. See MMImageColorspace 
MM IMAGE PROFILE HAS ALPHA image has-alpah channel. This is an integer field 
MM IMAGE PROFILE PIXEL DATA image pixel-data 
MM IMAGE PROFILE NUM number of image profile attributes 
MM IMAGE PROFILE CODEC image type. See MMImageCodecType 
MM IMAGE PROFILE WIDTH image width. This is an integer field 
MM IMAGE PROFILE HEIGHT image height. This is an integer field 
MM IMAGE PROFILE ROW STRIDE image row-stride. This is an integer field 
MM IMAGE PROFILE BIT PER SAMPLE image bit-per-sample. This is an integer field 
MM IMAGE PROFILE CHANNELS image number of channels. This is an integer field 
MM IMAGE PROFILE COLORSPACE image colorspace. See MMImageColorspace 
MM IMAGE PROFILE HAS ALPHA image has-alpah channel. This is an integer field 
MM IMAGE PROFILE PIXEL DATA image pixel-data 
MM IMAGE PROFILE NUM number of image profile attributes 


5.3.4 Function Documentation 
5.3.41 іш MMImageCreateFromFile (MMHandleType х image, const char x filename) 


Create MMImage from the specified file name 
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Parameters: 


image [out] MMImage instance. 


filename [in] Image file's full path to decode 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMImageDestroy 


5.3.4.2 int MMImageDestroy (MMHandleType image) 
Destroy the MMImage 


Parameters: 


image [in] MMImage to cleanup 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMImageCreateFromFile 


5.3.4.3 іш MMImageEncodeToFile (MMHandleType image, const char x filename) 


Encode the MMImage to the specified file with codec-properties. If you did not set codec properties, 
default codec-properties will be used 


Parameters: 
image [in] MMImage 


filename [in] Image file name to save 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 
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5.3.4.4 int MMImageGetAttrs (MMHandleType image, MMImageAttrsType type, 
MMHandleType x attrs) 


Get the attributes of MMImage with a attributes type. 


Parameters: 
image [in] MMImage 
type [in] Attribute type of image 


attrs [out] On return contains the attributes. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMImageSetAttrs 


5.3.4.5 int MMImageGetData (MMHandleType image, void х data, int х size) 
Get real data of image from handle. 


Parameters: 
image [in] Handle of image 
data [out] Buffer which carries raw image data. 


size [in/out] Size of image buffer. On return this represents num of bytes written to Buffer 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


5.3.4.6 int MMImageSetAttrs (MMHandleType image, MMImageAttrsType type, MMHandleType 
attrs) 


MMImageSetProperty Set the MMImage property to the MMImage 


Parameters: 


image [in] MMImage 
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attrs [in] MMImage attributes handle to set 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMImageGetAttrs 
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5.4 Player 
5.41 Detailed Description 


This part describes the APIs with respect to playback of multimedia contents. All multimedia contents 
are created by a media player through handle of playback, pause and resume. In creating a player, it 
displays the player’s status or information by registering callback function. 


Player can have 5 states, and each state can be changed by calling described functions on figure "State 
of mmfplayer". 


= 


MMPlayerCreate() | ыны 


MMPlayerRealize() 


p 


| MMPlayerUnrealize0 


E 
e 


ынаа] 


MMPlayerResume() 


Figure 5.2: State of Player 


АП the functions which change state of player are asynchronous call. It returns immediately and con- 
firm success of changing state will be notified through message callback function. If state is changed 
successfully, callback function will be received state message of new state, if not it will be received 
error message. 


Note that "None" state could be reached from any state by calling MMPlayerDestroy 


Following are the attributes which may be set before initialization (MMPlayerRealize): MM - 
PLAYER ATTRS PROFILE, MM PLAYER ATTRS CONTENT, MM PLAYER ATTRS TAG, 
MM PLAYER ATTRS DISPLAY 


Following are the attributes which may be set after initialization: < Empty list currently > 
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FUNCTION PRE-STATE POST-STATE SYNC TYPE 
MMPlayerCreate() NONE NULL SYNC 
MMPlayerDestroy() NULL NONE SYNC 
MMPlayerRealize() NULL READY ASYNC 
MMPlayerUnrealize() | READY NULL ASYNC 
MMPlayerStart() READY PLAYING ASYNC 
MMPlayerStop() PLAYING READY ASYNC 
MMPlayerPause() PLAYING PAUSED ASYNC 
MMPlayerResume() PAUSED PLAYING ASYNC 
MMPlayerSet- N/A N/A SYNC 
MessageCallback() 
MMPlayerGetState() N/A N/A SYNC 
MMPlayerSet- N/A N/A SYNC 
Volume() 
MMPlayerGet- N/A N/A SYNC 
Volume() 
MMPlayerSetPlay- N/A N/A SYNC 
Speed() 
MMPlayerSet- N/A N/A SYNC 
Position() 
MMPlayerGet- N/A N/A SYNC 
Position() 
MMPlayerSetAttrs() N/A N/A SYNC 
MMPlayerGetAttrs() N/A N/A SYNC 


The table below is attribute lists for player. 
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PROPERTY TYPE VALID TYPE CATEGORY 
uri string N/A Profile 
priority int Range 

user-param data N/A 

duration int Range Content 
video-codec int Array 

video-bitrate int Array 

video-fps int Array 

video-width int Range 

video-height int Range 

video-track-id int Range 

video-track-num int Range 

audio-codec int Array 

audio-bitrate int Array 

audio-channel int Range 

audio-samplerate int Array 

audio-track-id int Range 

audio-track-num int Range 

artist string N/A Tag 
title string N/A 

album string N/A 

genre string N/A 

author string N/A 

copyright string N/A 

date string N/A 

description string N/A 

track-num string N/A 

device int Range Display 
х int Range 

y int Range 

width int Range 

height int Range 

scale int Array 

rotation int Array 


Data Structures 


* struct MMPlayerVolumeType 


* struct MMPlayerVolumeType 


Enumerations 


e enum MMPlayerStateType { 


MM PLAYER STATE NULL, 
PLAYING, MM PLAYER STATE PAUSED, 


ММ PLAYER STATE READY, 


ММ PLAYER STATE - 


MM PLAYER STATE NUM, MM PLAYER STATE NULL, MM PLAYER STATE READY, 


MM PLAYER STATE PLAYING, 


MM PLAYER STATE PAUSED, MM PLAYER STATE NUM ] 
* enum MMPlayerPosFormatType { 
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MM PLAYER POS FORMAT TIME, MM PLAYER POS FORMAT FRAME, MM - 
PLAYER POS FORMAT PERCENT, MM PLAYER POS FORMAT NUM, 


MM PLAYER POS FORMAT TIME, MM PLAYER POS FORMAT FRAME, MM - 
PLAYER POS FORMAT PERCENT, MM PLAYER POS FORMAT NUM } 
enum MMPlayerAttrsType { 


MM PLAYER ATTRS PROFILE, ММ PLAYER ATTRS CONTENT, MM PLAYER - 
ATTRS TAG, MM PLAYER ATTRS DISPLAY, 


MM PLAYER ATTRS NUM, MM PLAYER ATTRS PROFILE, MM PLAYER ATTRS - 
CONTENT, MM PLAYER ATTRS TAG, 


MM PLAYER ATTRS DISPLAY, MM PLAYER ATTRS NUM } 
enum MMPlayerProfileID { 


MM PLAYER PROFILE URI, MM PLAYER PROFILE PRIORITY, MM PLAYER - 
PROFILE PARAM, MM PLAYER PROFILE NUM, 


MM PLAYER PROFILE URI, MM PLAYER PROFILE PRIORITY, MM PLAYER - 
PROFILE PARAM, MM PLAYER PROFILE NUM } 


enum MMPlayerContentID { 


MM PLAYER CONTENT DURATION, MM PLAYER CONTENT VIDEO CODEC, MM - 
PLAYER CONTENT VIDEO BITRATE, MM PLAYER CONTENT VIDEO FPS, 


MM PLAYER CONTENT VIDEO WIDTH, | MM PLAYER CONTENT VIDEO HEIGHT, 


MM PLAYER CONTENT VIDEO TRACK ID, MM PLAYER CONTENT VIDEO - 
TRACK NUM, 
MM PLAYER CONTENT AUDIO CODEC, MM PLAYER CONTENT AUDIO BITRATE, 
MM PLAYER CONTENT AUDIO CHANNELS, MM PLAYER CONTENT AUDIO - 
SAMPLERATE, 
MM PLAYER CONTENT AUDIO TRACK ID, MM PLAYER CONTENT AUDIO - 


TRACK NUM, MM PLAYER CONTENT NUM, MM PLAYER CONTENT DURATION, 


MM PLAYER CONTENT VIDEO CODEC, MM PLAYER CONTENT VIDEO BITRATE, 
MM PLAYER CONTENT VIDEO FPS, MM PLAYER CONTENT VIDEO WIDTH, 


MM PLAYER CONTENT VIDEO HEIGHT, MM PLAYER CONTENT VIDEO TRACK - 
ID, MM PLAYER CONTENT VIDEO TRACK NUM, MM PLAYER CONTENT AUDIO - 
CODEC, 


MM PLAYER CONTENT AUDIO BITRATE, MM PLAYER CONTENT AUDIO - 
CHANNELS, MM PLAYER CONTENT AUDIO SAMPLERATE, MM PLAYER - 
CONTENT AUDIO TRACK ID, 

MM PLAYER CONTENT AUDIO TRACK NUM, MM PLAYER CONTENT NUM } 

enum MMPlayerAttrsTagID 1 


MM PLAYER TAG ARTIST, MM PLAYER TAG TITLE, MM PLAYER TAG ALBUM, 
MM PLAYER TAG GENRE, 


MM PLAYER TAG AUTHOR, MM PLAYER TAG COPYRIGHT, MM PLAYER TAG - 
DATE, MM PLAYER TAG DESCRIPTION, 


MM PLAYER TAG TRACK NUM, MM PLAYER TAG NUM, MM PLAYER TAG - 
ARTIST, MM PLAYER TAG TITLE, 


MM PLAYER TAG ALBUM, MM PLAYER TAG GENRE, MM PLAYER TAG AUTHOR, 
MM PLAYER TAG COPYRIGHT, 


MM PLAYER TAG DATE, ММ PLAYER TAG DESCRIPTION, ММ PLAYER TAG - 
TRACK NUM, MM PLAYER TAG NUM } 
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enum MMPlayerDisplayID { 


ММ PLAYER DISPLAY DEVICE, MM PLAYER DISPLAY X, MM PLAYER DISPLAY Y, 
MM PLAYER DISPLAY WIDTH, 


MM PLAYER DISPLAY HEIGHT, ММ PLAYER DISPLAY SCALE, ММ PLAYER - 
DISPLAY ROTATION, MM PLAYER DISPLAY NUM, 


MM PLAYER DISPLAY DEVICE, MM PLAYER DISPLAY X, MM PLAYER DISPLAY Y, 
MM PLAYER DISPLAY WIDTH, 


ММ PLAYER DISPLAY HEIGHT, | MM PLAYER DISPLAY SCALE, ММ PLAYER - 
DISPLAY ROTATION, MM PLAYER DISPLAY NUM } 
enum MMPlayerStateType { 


MM PLAYER STATE NULL, ММ PLAYER STATE READY, ММ PLAYER STATE - 
PLAYING, MM PLAYER STATE PAUSED, 


MM PLAYER STATE NUM, MM PLAYER STATE NULL, MM PLAYER STATE READY, 
ММ PLAYER STATE PLAYING, 

MM PLAYER STATE PAUSED, MM PLAYER STATE NUM } 

enum MMPlayerPosFormatType { 

MM PLAYER POS FORMAT TIME, MM PLAYER POS FORMAT FRAME, MM - 
PLAYER POS FORMAT PERCENT, MM PLAYER POS FORMAT NUM, 

MM PLAYER POS FORMAT TIME, MM PLAYER POS FORMAT FRAME, MM - 
PLAYER POS FORMAT PERCENT, MM PLAYER POS FORMAT NUM } 

enum MMPlayerAttrsType { 

ММ PLAYER ATTRS PROFILE, MM. PLAYER ATTRS CONTENT, MM PLAYER - 
ATTRS TAG, MM PLAYER ATTRS DISPLAY, 

MM PLAYER ATTRS NUM, MM PLAYER ATTRS PROFILE, MM PLAYER ATTRS - 
CONTENT, MM PLAYER ATTRS TAG, 

MM PLAYER ATTRS DISPLAY, MM PLAYER ATTRS NUM } 

enum MMPlayerProfileID { 

MM PLAYER PROFILE URI, MM PLAYER PROFILE PRIORITY, MM PLAYER - 
PROFILE PARAM, MM PLAYER PROFILE NUM, 

MM PLAYER PROFILE URI, MM PLAYER PROFILE PRIORITY, MM PLAYER - 
PROFILE PARAM, MM PLAYER PROFILE NUM } 

enum MMPlayerContentID { 

MM PLAYER CONTENT DURATION, MM PLAYER CONTENT VIDEO CODEC, MM - 
PLAYER CONTENT VIDEO BITRATE, MM PLAYER CONTENT VIDEO FPS, 


MM PLAYER CONTENT VIDEO WIDTH, | MM PLAYER CONTENT VIDEO HEIGHT, 


MM PLAYER CONTENT VIDEO TRACK ID, MM PLAYER CONTENT VIDEO - 
TRACK NUM, 
MM PLAYER CONTENT AUDIO CODEC, MM PLAYER CONTENT AUDIO BITRATE, 
MM PLAYER CONTENT AUDIO CHANNELS, MM PLAYER CONTENT AUDIO - 
SAMPLERATE, 
MM PLAYER CONTENT AUDIO TRACK ID, MM PLAYER CONTENT AUDIO - 


TRACK NUM, MM PLAYER CONTENT NUM, MM PLAYER CONTENT DURATION, 


MM PLAYER CONTENT VIDEO CODEC, MM PLAYER CONTENT VIDEO BITRATE, 
MM. PLAYER CONTENT VIDEO FPS, MM PLAYER CONTENT VIDEO WIDTH, 


MM PLAYER CONTENT VIDEO HEIGHT, MM PLAYER CONTENT VIDEO TRACK - 
ID, MM PLAYER CONTENT VIDEO TRACK NUM, MM PLAYER CONTENT AUDIO - 
CODEC, 
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MM PLAYER CONTENT AUDIO BITRATE, MM PLAYER CONTENT AUDIO - 
CHANNELS, MM PLAYER CONTENT AUDIO SAMPLERATE, MM PLAYER - 
CONTENT AUDIO TRACK ID, 

MM PLAYER CONTENT AUDIO TRACK NUM, MM PLAYER CONTENT NUM } 

enum MMPlayerAttrsTagID { 


MM PLAYER TAG ARTIST, MM PLAYER TAG TITLE, MM PLAYER TAG ALBUM, 
MM PLAYER TAG GENRE, 


MM PLAYER TAG AUTHOR, MM PLAYER TAG COPYRIGHT, MM PLAYER TAG - 
DATE, MM PLAYER TAG DESCRIPTION, 


MM PLAYER TAG TRACK NUM, MM PLAYER TAG NUM, MM PLAYER TAG - 
ARTIST, MM PLAYER TAG TITLE, 


MM PLAYER TAG ALBUM, MM PLAYER TAG GENRE, MM PLAYER TAG AUTHOR, 
MM PLAYER TAG COPYRIGHT, 


MM PLAYER TAG DATE, ММ PLAYER TAG DESCRIPTION, ММ PLAYER TAG - 
TRACK NUM, MM PLAYER TAG NUM } 
enum MMPlayerDisplayID { 


MM PLAYER DISPLAY DEVICE, MM PLAYER DISPLAY X, MM PLAYER DISPLAY Y, 
MM PLAYER DISPLAY WIDTH, 


MM PLAYER DISPLAY HEIGHT, ММ PLAYER DISPLAY SCALE, ММ PLAYER - 
DISPLAY ROTATION, MM PLAYER DISPLAY NUM, 


MM PLAYER DISPLAY DEVICE, MM PLAYER DISPLAY X, MM PLAYER DISPLAY Y, 
MM PLAYER DISPLAY WIDTH, 


MM PLAYER DISPLAY HEIGHT, ММ PLAYER DISPLAY SCALE, ММ PLAYER - 
DISPLAY ROTATION, MM PLAYER DISPLAY NUM } 


Functions 


int MMPlayerCreate (MMHandleType «player) 
int MMPlayerDestroy (MMHandleType player) 
int MMPlayerRealize (MMHandleType player) 
int MMPlayerUnrealize (MMHandleType player) 


int MMPlayerSetMessageCallback (MMHandleType player, MMMessageCallback callback, void 
*user param) 


int MMPlayerGetState (MMHandleType player, MMPlayerStateType xstate) 

int MMPlayerSetVolume (MMHandleType player, MMPlayerVolumeType жүоішпе) 

int MMPlayerGetVolume (MMHandleType player, MMPlayerVolumeType xvolume) 

int MMPlayerStart (MMHandleType player) 

int MMPlayerStop (MMHandleType player) 

int MMPlayerPause (MMHandleType player) 

int MMPlayerResume (MMHandleType player) 

int MMPlayerSetPlaySpeed (MMHandleType player, float ratio) 

int MMPlayerSetPosition (MMHandleType player, MMPlayerPosFormatType format, int pos) 

int MMPlayerGetPosition (MMHandleType player, MMPlayerPosFormatType format, int жров) 
int MMPlayerGetAttrs (MMHandleType player, MMPlayerAttrsType type, MMHandleType xattrs) 
int MMPlayerSetAttrs (MMHandleType player, MMPlayerAttrsType type, MMHandleType attrs) 
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5.4.2 Enumeration Type Documentation 
5.4.2.1 enum MMPlayerAttrsTagID 
Enumerations of tag attribute ID. 


Enumerator: 


MM PLAYER TAG ARTIST Artist. This is a string field 

MM PLAYER TAG TITLE Title. This is a string field 

MM PLAYER TAG ALBUM Album. This is a string field 

MM PLAYER TAG GENRE Gente. This is a string field 

MM PLAYER TAG AUTHOR Author / Composer. This is a string field 

MM PLAYER TAG COPYRIGHT Copyright. This is a string field 

MM PLAYER TAG DATE Date. This is a string field 

MM PLAYER TAG DESCRIPTION Description. This is a string field 

MM PLAYER TAG TRACK NUM Number of tracks. This is an integer field 
MM PLAYER TAG NUM Number of tag attributes 

MM PLAYER TAG ARTIST Artist. This is a string field 

MM PLAYER TAG TITLE Title. This is a string field 

MM PLAYER TAG ALBUM Album. This is a string field 

MM PLAYER TAG GENRE Genre. This is a string field 

MM PLAYER TAG AUTHOR Author / Composer. This is a string field 

MM PLAYER TAG COPYRIGHT Copyright. This is a string field 

MM PLAYER TAG DATE Date. This is a string field 

MM PLAYER TAG DESCRIPTION Description. This is a string field 

MM PLAYER TAG TRACK NUM Number of tracks. This is an integer field 
MM PLAYER TAG NUM Number of tag attributes 


5.4.2.2 enum MMPlayerAttrsTagID 
Enumerations of tag attribute ID. 


Enumerator: 


MM PLAYER TAG ARTIST Artist. This is a string field 

MM PLAYER TAG TITLE Title. This is a string field 

MM PLAYER TAG ALBUM Album. This is a string field 

MM PLAYER TAG GENRE Gente. This is a string field 

MM PLAYER TAG AUTHOR Author / Composer. This is a string field 

MM PLAYER TAG COPYRIGHT Copyright. This is a string field 

MM PLAYER TAG DATE Date. This is a string field 

MM PLAYER TAG DESCRIPTION Description. This is a string field 

MM PLAYER TAG TRACK NUM Number of tracks. This is an integer field 
MM PLAYER TAG NUM Number of tag attributes 
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MM PLAYER TAG ARTIST Artist. This is a string field 

MM PLAYER TAG TITLE Title. This is a string field 

MM PLAYER TAG ALBUM Album. This is a string field 

MM PLAYER TAG GENRE Gente. This is a string field 

MM PLAYER TAG AUTHOR Author / Composer. This is a string field 

MM PLAYER TAG COPYRIGHT Copyright. This is a string field 

MM PLAYER TAG DATE Date. This is a string field 

MM PLAYER TAG DESCRIPTION Description. This is a string field 

MM PLAYER TAG TRACK NUM Number of tracks. This is an integer field 
MM PLAYER TAG NUM Number of tag attributes 


5.4.2.3 enum MMPlayerAttrsType 


Enumerations of player attributes types. 


Enumerator: 
MM PLAYER ATTRS PROFILE Basic configurations for player. See MMPlayerProfileID for 
subclassification 
MM PLAYER ATTRS CONTENT Contents. See MMPlayerContentID for subclassification 
MM PLAYER ATTRS TAG Tag (Metadata). See MMPlayerAttrsTagID for subclassification 
MM PLAYER ATTRS DISPLAY Display device.See MMPlayerDisplayID for subclassification 
MM PLAYER ATTRS NUM Number of player attributes types 


MM PLAYER ATTRS PROFILE Basic configurations for player. See MMPlayerProfileID for 
subclassification 


MM PLAYER ATTRS CONTENT Contents. See MMPlayerContentID for subclassification 
MM PLAYER ATTRS TAG Tag (Metadata). See MMPlayerAttrsTagID for subclassification 
MM PLAYER ATTRS DISPLAY Display device.See MMPlayerDisplayID for subclassification 
MM PLAYER ATTRS NUM Number of player attributes types 


5.4.2.4 enum MMPlayerAttrsType 


Enumerations of player attributes types. 


Enumerator: 
MM PLAYER ATTRS PROFILE Basic configurations for player. See MMPlayerProfileID for 
subclassification 
MM PLAYER ATTRS CONTENT Contents. See MMPlayerContentID for subclassification 
MM PLAYER ATTRS TAG Tag (Metadata). See MMPlayerAttrsTagID for subclassification 
MM PLAYER ATTRS DISPLAY Display device.See MMPlayerDisplayID for subclassification 
MM PLAYER ATTRS NUM Number of player attributes types 


MM PLAYER ATTRS PROFILE Basic configurations for player. See MMPlayerProfileID for 
subclassification 


MM PLAYER ATTRS CONTENT Contents. See MMPlayerContentID for subclassification 
MM PLAYER ATTRS TAG Tag (Metadata). See MMPlayerAttrsTagID for subclassification 
MM PLAYER ATTRS DISPLAY Display device.See MMPlayerDisplayID for subclassification 
MM PLAYER ATTRS NUM Number of player attributes types 
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5.4.2.5 enum MMPlayerContentID 


Enumerations of content attribute ID. 


Enumerator: 


MM PLAYER CONTENT DURATION Duration of media. This is an integer field 
MM PLAYER CONTENT VIDEO CODEC Used video codec id. This is a string field 
MM PLAYER CONTENT VIDEO BITRATE Bitrate of video stream. This is an integer field 


MM PLAYER CONTENT VIDEO FPS Frames per second of video stream. This is an integer 
field 


MM PLAYER CONTENT VIDEO WIDTH Width of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO HEIGHT Height of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO TRACK ID Current stream of video. This is an integer field 


MM PLAYER CONTENT VIDEO TRACK NUM Number of video streams. This is an integer 
field 


MM PLAYER CONTENT AUDIO CODEC Used audio codec id. This is a string field 
MM PLAYER CONTENT AUDIO BITRATE Bitrate of audio stream. This is an integer field 


MM PLAYER CONTENT AUDIO CHANNELS Channels of audio stream. This is an integer 
field 


MM PLAYER CONTENT AUDIO SAMPLERATE Sampling rate of audio stream. This is an 
integer field 


MM PLAYER CONTENT AUDIO TRACK ID Current stream of audio. This is an integer field 


MM PLAYER CONTENT AUDIO TRACK NUM Number of audio streams. This is an integer 
field 


MM PLAYER CONTENT NUM Number of content attributes 

MM PLAYER CONTENT DURATION Duration of media. This is an integer field 

MM PLAYER CONTENT VIDEO CODEC Used video codec id. This is a string field 

MM PLAYER CONTENT VIDEO BITRATE Bitrate of video stream. This is an integer field 


MM PLAYER CONTENT VIDEO FPS Frames per second of video stream. This is an integer 
field 


MM PLAYER CONTENT VIDEO WIDTH Width of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO HEIGHT Height of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO TRACK ID Current stream of video. This is an integer field 


MM PLAYER CONTENT VIDEO TRACK NUM Number of video streams. This is an integer 
field 


MM PLAYER CONTENT AUDIO CODEC Used audio codec id. This is a string field 
MM PLAYER CONTENT AUDIO BITRATE Bitrate of audio stream. This is an integer field 


MM PLAYER CONTENT AUDIO CHANNELS Channels of audio stream. This is an integer 
field 


MM PLAYER CONTENT AUDIO SAMPLERATE Sampling rate of audio stream. This is an 
integer field 


MM PLAYER CONTENT AUDIO TRACK ID Current stream of audio. This is an integer field 


MM PLAYER CONTENT AUDIO TRACK NUM Number of audio streams. This is an integer 
field 


MM PLAYER CONTENT NUM Number of content attributes 
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5.4.2.6 enum MMPlayerContentID 


Enumerations of content attribute ID. 


Enumerator: 


MM PLAYER CONTENT DURATION Duration of media. This is an integer field 
MM PLAYER CONTENT VIDEO CODEC Used video codec id. This is a string field 
MM PLAYER CONTENT VIDEO BITRATE Bitrate of video stream. This is an integer field 


MM PLAYER CONTENT VIDEO FPS Frames per second of video stream. This is an integer 
field 


MM PLAYER CONTENT VIDEO WIDTH Width of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO HEIGHT Height of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO TRACK ID Current stream of video. This is an integer field 


MM PLAYER CONTENT VIDEO TRACK NUM Number of video streams. This is an integer 
field 


MM PLAYER CONTENT AUDIO CODEC Used audio codec id. This is a string field 
MM PLAYER CONTENT AUDIO BITRATE Bitrate of audio stream. This is an integer field 


MM PLAYER CONTENT AUDIO CHANNELS Channels of audio stream. This is an integer 
field 


MM PLAYER CONTENT AUDIO SAMPLERATE Sampling rate of audio stream. This is an 
integer field 


MM PLAYER CONTENT AUDIO TRACK ID Current stream of audio. This is an integer field 


MM PLAYER CONTENT AUDIO TRACK NUM Number of audio streams. This is an integer 
field 


MM PLAYER CONTENT NUM Number of content attributes 

MM PLAYER CONTENT DURATION Duration of media. This is an integer field 

MM PLAYER CONTENT VIDEO CODEC Used video codec id. This is a string field 

MM PLAYER CONTENT VIDEO BITRATE Bitrate of video stream. This is an integer field 


MM PLAYER CONTENT VIDEO FPS Frames per second of video stream. This is an integer 
field 


MM PLAYER CONTENT VIDEO WIDTH Width of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO HEIGHT Height of video stream. This is an integer field 
MM PLAYER CONTENT VIDEO TRACK ID Current stream of video. This is an integer field 


MM PLAYER CONTENT VIDEO TRACK NUM Number of video streams. This is an integer 
field 


MM PLAYER CONTENT AUDIO CODEC Used audio codec id. This is a string field 
MM PLAYER CONTENT AUDIO BITRATE Bitrate of audio stream. This is an integer field 


MM PLAYER CONTENT AUDIO CHANNELS Channels of audio stream. This is an integer 
field 


MM PLAYER CONTENT AUDIO SAMPLERATE Sampling rate of audio stream. This is an 
integer field 


MM PLAYER CONTENT AUDIO TRACK ID Current stream of audio. This is an integer field 


MM PLAYER CONTENT AUDIO TRACK NUM Number of audio streams. This is an integer 
field 


MM PLAYER CONTENT NUM Number of content attributes 
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5.4.27 enum MMPlayerDisplayID 


Enumerations of display attribute ID. 


Enumerator: 


MM PLAYER DISPLAY DEVICE Device id of display. This is a data field 
MM PLAYER DISPLAY X x position of display. This is an integer field 

MM PLAYER DISPLAY Y y positoin of display. This is an integer field 

MM PLAYER DISPLAY WIDTH Width of display. This is an integer field 
MM PLAYER DISPLAY HEIGHT Height of display. This is an integer field 
MM PLAYER DISPLAY SCALE Scale of display. This is an integer field 


MM PLAYER DISPLAY ROTATION Rotation of display. See MMDisplayRotationType for pos- 
sible values 


MM PLAYER DISPLAY NUM Number of display attributes 

MM PLAYER DISPLAY DEVICE Device id of display. This is a data field 
MM PLAYER DISPLAY X x position of display. This is an integer field 

MM PLAYER DISPLAY Y y positoin of display. This is an integer field 

MM PLAYER DISPLAY WIDTH Width of display. This is an integer field 
MM PLAYER DISPLAY HEIGHT Height of display. This is an integer field 
MM PLAYER DISPLAY SCALE Scale of display. This is an integer field 


MM PLAYER DISPLAY ROTATION Rotation of display. See MMDisplayRotationType for pos- 
sible values 


MM PLAYER DISPLAY NUM Number of display attributes 


5.4.2.8 enum MMPlayerDisplayID 


Enumerations of display attribute ID. 
Enumerator: 


MM PLAYER DISPLAY DEVICE Device id of display. This is a data field 
MM PLAYER DISPLAY X x position of display. This is an integer field 

MM PLAYER DISPLAY Y y positoin of display. This is an integer field 

MM PLAYER DISPLAY WIDTH Width of display. This is an integer field 
MM PLAYER DISPLAY HEIGHT Height of display. This is an integer field 
MM PLAYER DISPLAY SCALE Scale of display. This is an integer field 


MM PLAYER DISPLAY ROTATION Rotation of display. See MMDisplayRotationType for pos- 
sible values 


MM PLAYER DISPLAY NUM Number of display attributes 

MM PLAYER DISPLAY DEVICE Device id of display. This is a data field 
MM PLAYER DISPLAY X x position of display. This is an integer field 

MM PLAYER DISPLAY Y y positoin of display. This is an integer field 

MM PLAYER DISPLAY WIDTH Width of display. This is an integer field 
MM PLAYER DISPLAY HEIGHT Height of display. This is an integer field 
MM PLAYER DISPLAY SCALE Scale of display. This is an integer field 


MM PLAYER DISPLAY ROTATION Rotation of display. See MMDisplayRotationType for pos- 
sible values 


MM PLAYER DISPLAY NUM Number of display attributes 
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5.4.2.9 enum MMPlayerPosFormatType 
Enumerations of position formats. Used while invoking MMPlayerGet/SetPosition APIs 


Enumerator: 

MM PLAYER POS FORMAT TIME Format for time based 

MM PLAYER POS FORMAT FRAME Format for frame based 
MM PLAYER POS FORMAT PERCENT Format for percentage 
MM PLAYER POS FORMAT NUM Number of position formats 
MM PLAYER POS FORMAT TIME Format for time based 

MM PLAYER POS FORMAT FRAME Format for frame based 
MM PLAYER POS FORMAT PERCENT Format for percentage 
MM PLAYER POS FORMAT NUM Number of position formats 


5.4.2.10 enum MMPlayerPosFormatType 
Enumerations of position formats. Used while invoking MMPlayerGet/SetPosition APIs 


Enumerator: 

MM PLAYER POS FORMAT TIME Format for time based 

MM PLAYER POS FORMAT FRAME Format for frame based 
MM PLAYER POS FORMAT PERCENT Format for percentage 
MM PLAYER POS FORMAT NUM Number of position formats 
MM PLAYER POS FORMAT TIME Format for time based 

MM PLAYER POS FORMAT FRAME Format for frame based 
MM PLAYER POS FORMAT PERCENT Format for percentage 
MM PLAYER POS FORMAT NUM Number of position formats 


5.4.2.11 enum MMPlayerProfileID 
Enumerations of profile attribute ID. 


Enumerator: 

MM PLAYER PROFILE URI Unified Resource Indicator. This is a string field 
MM PLAYER PROFILE PRIORITY Priority of player. This is an integer field 
MM PLAYER PROFILE PARAM Extra user parameter. This is a data field 
MM PLAYER PROFILE NUM Number of profile attributes 

MM PLAYER PROFILE URI Unified Resource Indicator. This is a string field 
MM PLAYER PROFILE PRIORITY Priority of player. This is an integer field 
MM PLAYER PROFILE PARAM Extra user parameter. This is a data field 
MM PLAYER PROFILE NUM Number of profile attributes 
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5.4.212 enum MMPlayerProfileID 


Enumerations of profile attribute ID. 


Enumerator: 


MM PLAYER PROFILE URI Unified Resource Indicator. This is a string field 
MM PLAYER PROFILE PRIORITY Priority of player. This is an integer field 
MM PLAYER PROFILE PARAM Extra user parameter. This is a data field 
MM PLAYER PROFILE NUM Number of profile attributes 

MM PLAYER PROFILE URI Unified Resource Indicator. This is a string field 
MM PLAYER PROFILE PRIORITY Priority of player. This is an integer field 
MM PLAYER PROFILE PARAM Extra user parameter. This is a data field 
MM PLAYER PROFILE NUM Number of profile attributes 


5.4.2.13 enum MMPlayerStateType 


Enumerations of player state. 


Enumerator: 


MM PLAYER STATE NULL Player is created, but not realized yet 
MM PLAYER STATE READY Player is ready to play media 

MM PLAYER STATE PLAYING Player is now playing media 

MM PLAYER STATE PAUSED Player is paused while playing media 
MM PLAYER STATE NUM Number of player states 

MM PLAYER STATE NULL Player is created, but not realized yet 
MM PLAYER STATE READY Player is ready to play media 

MM PLAYER STATE PLAYING Player is now playing media 

MM PLAYER STATE PAUSED Player is paused while playing media 
MM PLAYER STATE NUM Number of player states 


5.4.2.14 enum MMPlayerStateType 


Enumerations of player state. 


Enumerator: 


MM PLAYER STATE NULL Player is created, but not realized yet 
MM PLAYER STATE READY Player is ready to play media 

MM PLAYER STATE PLAYING Player is now playing media 

MM PLAYER STATE PAUSED Player is paused while playing media 
MM PLAYER STATE NUM Number of player states 

MM PLAYER STATE NULL Player is created, but not realized yet 
MM PLAYER STATE READY Player is ready to play media 

MM PLAYER STATE PLAYING Player is now playing media 

MM PLAYER STATE PAUSED Player is paused while playing media 
MM PLAYER STATE NUM Number of player states 
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5.4.3 Function Documentation 
5.4.3.1 int MMPlayerCreate (MMHandleType ж player) 
This function creats a player for playing multimedia contents. 


Parameters: 


player [out] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerDestroy 


Precondition: 


MM PLAYER STATE NONE 


Postcondition: 


MM PLAYER STATE NULL 


5.4.3.2 int MMPlayerDestroy (MMHandleType player) 
This function deletes player and release all the resources allocated for playback. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 
This method could be called with a valid player handle from any state to completely shutdown the 
player operation 

See also: 


MMPlayerCreate 


Precondition: 


MM PLAYER STATE NULL 


Postcondition: 


MM PLAYER STATE NONE 
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5.4.3.5 int MMPlayerGetAttrs (MMHandleType player, MMPlayerAttrsType type, 
MMHandleType x attrs) 


This function is to get the attributes of player with given type. 


Parameters: 
player [in] Handle of player. 
type [in] Type of attributes. 


attrs [out] Refernce to attributes. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerSetAttrs 


5.4.3.4 int MMPlayerGetPosition (MMHandleType player, MMPlayerPosFormatType format, int 
* pos) 


This function is to get the position for playback. 


Parameters: 
player [in] Handle of player. 
format [in] Format of position. 


pos [out] contains current position on success or zero in case of failure. 


Returns: 


Returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerPosFormatType MMPlayerSetPosition 


5.4.3.5 int MMPlayerGetState (MMHandleType player, MMPlayerStateType х state) 
This function is to get current state of player. 


Parameters: 


player [in] Handle of player. 
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state [out] current state of player on success. 


Returns: 


This function returns zero. 


Remarks: 


See also: 


MMPlayerStateType 


5.4.3.6 int MMPlayerGetVolume (MMHandleType player, MMPlayerVolumeType ж volume) 


This function is to get current relative volume of player. 


Parameters: 
player [in] Handle of player. 


volume [out] Volume levels of each channel. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


Volume range is from MM VOLUME LEVEL MIN to MM VOLUME LEVEL MIN. 


See also: 


MMPlayerVolumeType MMPlayerSetVolume 


5.4.3.7 int MMPlayerPause (MMHandleType player) 


This function is to pause playing media contents. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerResume 
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Precondition: 


MM PLAYER STATE PLAYING 


Postcondition: 


MM PLAYER STATE PAUSED 


5.4.3.8 int MMPlayerRealize (MMHandleType player) 


This function obtains resources for playback and performs time-consuming initialization tasks. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerUnrealize 


Precondition: 


MM PLAYER STATE NULL 


Postcondition: 


MM PLAYER STATE READY 


5.4.3.9 int MMPlayerResume (MMHandleType player) 


This function is to resume paused media contents. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerPause 
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Precondition: 


MM PLAYER STATE PAUSED 


Postcondition: 


MM PLAYER STATE PLAYING 


5.4.3.10 int MMPlayerSetAttrs (MMHandleType player, MMPlayerAttrsType type, 
MMHandleType attrs) 


This function is to set the attributes of player with given type. 


Parameters: 
player [in] Handle of player. 
type [in] Type of attribute. 
attrs [їп] Attributes of player. 


Returns: 


This function returns zero on success, or negative value with error code 


Remarks: 


See also: 


MMPlayerGetAttrs 


5.4.3.11 int MMPlayerSetMessageCallback (MMHandleType player, MMMessageCallback 
callback, void ж user. param) 


This function set callback function for receiving messages from player. 


Parameters: 
player [in] Handle of player. 
callback |in] Message callback function. 


user param [in] User parameter which is passed to callback function. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMMessageCallback 
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5.4.3.12 int MMPlayerSetPlaySpeed (MMHandleType player, float ratio) 


This function is to set play speed for playback. 


Parameters: 
player [in] Handle of plyaer. 
ratio [in] Speed for playback. 


Returns: 


This function returns zero on success, or negative value with error code 


Remarks: 


See also: 


5.4.3.13 int MMPlayerSetPosition (MMHandleType player, MMPlayerPosFormatType format, int 
pos) 


This function is to set the position for playback. 


Parameters: 
player [in] Handle of player. 
format [in] Format of position. 


pos [in] Position for playback. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerPosFormatType MMPlayerGetPosition 


5.4.3.14 int MMPlayerSetVolume (MMHandleType player, MMPlayer VolumeType * volume) 


This function is to set relative volume of player. 


Parameters: 
player [in] Handle of player. 


volume [in] Volume levels of each channel. 
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Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


Volume range is from MM VOLUME LEVEL MIN to MM VOLUME LEVEL MIN. 


See also: 


MMPlayerVolumeType MMPlayerGetVolume 


5.4.3.15 int MMPlayerStart (MMHandleType player) 


This function is to start playing media contents. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerStop 


Precondition: 


MM PLAYER STATE READY 


Postcondition: 


MM PLAYER STATE PLAYING 


5.4.3.16 int MMPlayerStop (MMHandleType player) 


This function is to stop playing media contents. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 
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See also: 


MMPlayerStart 


Precondition: 


MM PLAYER STATE PLAYING 


Postcondition: 


MM PLAYER STATE READY 


5.4.3.17 int MMPlayerUnrealize (MMHandleType player) 
This function uninitializes playback object. 


Parameters: 


player [in] Handle of player. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMPlayerRealize 


Precondition: 


MM PLAYER STATE READY 


Postcondition: 


MM PLAYER STATE NULL 
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Sound 


5.5.1 Detailed Description 


This part is describes the sound module of multimedia framework. Sound module provides APIs to 
implement controlling volume information, changing sound output or input direction. 


Enumerations 


enum MMSoundPathType { 


MM SOUND PATH OUT HFK = 0x00000001, MM. SOUND PATH OUT EARPHONE = 
0x00000002, ММ SOUND PATH OUT SPEAKER = 0x00000004, ММ SOUND PATH - 
OUT RECEIVER - 0x00000008, 


MM SOUND PATH OUT BLUETOOTH = 0x00000010, ММ SOUND PATH IN MIC = 
0x00010000, MM. SOUND PATH ІМ PHONE MIC = 0x00020000, MM. SOUND PATH IN - 
EARPHONE MIC - 0x00040000, 


MM SOUND PATH IN НЕК MIC = 0х00080000, ММ SOUND PATH OUT НЕК = 
0x00000001, ММ SOUND PATH OUT EARPHONE = 0x00000002, ММ SOUND PATH - 
OUT SPEAKER - 0x00000004, 


MM SOUND PATH OUT RECEIVER = 0х00000008, ММ SOUND PATH OUT - 
BLUETOOTH = 0x00000010, ММ SOUND PATH IN MIC = 0x00010000, MM SOUND - 
PATH. IN. PHONE MIC = 0x00020000, 


MM SOUND PATH IN EARPHONE MIC - 0x00040000, MM. SOUND PATH IN HFK MIC 
= 0x00080000 } 
enum MMSoundPathType { 


MM_SOUND_PATH_OUT_HFK = 0x00000001, MM. SOUND PATH OUT EARPHONE = 
0x00000002, ММ SOUND PATH OUT SPEAKER = 0x00000004, ММ SOUND PATH - 
OUT RECEIVER - 0x00000008, 


MM. SOUND PATH OUT BLUETOOTH = 0x00000010, MM SOUND PATH IN MIC = 
0x00010000, ММ SOUND PATH IN PHONE МІС = 0x00020000, ММ SOUND PATH IN - 
EARPHONE MIC = 0x00040000, 


MM SOUND PATH IN НЕК МІС = 0х00080000, ММ SOUND PATH OUT НЕК = 
0x00000001, ММ SOUND PATH OUT EARPHONE = 0x00000002, ММ SOUND PATH - 
OUT SPEAKER - 0x00000004, 


ММ SOUND PATH OUT RECHIVER = 0х00000008, ММ SOUND PATH OUT - 
BLUETOOTH = 0x00000010, ММ SOUND PATH IN MIC = 0x00010000, MM SOUND - 
PATH IN. PHONE MIC = 0x00020000, 


MM SOUND PATH IN EARPHONE MIC - 0x00040000, MM. SOUND PATH IN HFK MIC 
= 0x00080000 } 


Functions 


int MMSoundSetVolume (int volume) 

int MMSoundGetVolume (int жуо]) 

int MMSoundSetMute (bool mute) 

int MMSoundIsMute (bool «mute) 

int MMSoundGrabPath (int path, int «grab id) 
int MMSoundReleasePath (int grab, id) 
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e int MMSoundSetPath (int path) 
e int MMSoundGetPath (int xpath) 


5.5.2 Enumeration Type Documentation 
5.5.21 enum MMSoundPathType 
Enumerations of audio output path. 


Enumerator: 


MM SOUND 


PATH OUT HFK Sound path for Hands Free Kit 


MM SOUND 


PATH OUT EARPHONE Sound path for Earphone 


MM SOUND 


PATH OUT SPEAKER Sound path for Speaker 


MM SOUND 


MM SOUND 


PATH OUT RECEIVER Sound path for Receiver 
PATH OUT BLUETOOTH Sound path for Bluetooth 


MM SOUND 


PATH IN MIC Sound path for Microphone 


MM SOUND 


PATH IN PHONE MIC Sound path for phone 


MM SOUND 


PATH IN EARPHONE MIC Sound path for Earphone mic 


MM SOUND 


MM SOUND 


PATH IN HFK MIC Sound path for Hands Free Kit mic 
PATH OUT HFK Sound path for Hands Free Kit 


MM SOUND 


PATH OUT EARPHONE Sound path for Earphone 


MM SOUND 


PATH OUT SPEAKER Sound path for Speaker 


MM SOUND 


PATH OUT RECEIVER Sound path for Receiver 


MM SOUND 


PATH OUT BLUETOOTH Sound path for Bluetooth 


MM SOUND 


PATH IN MIC Sound path for Microphone 


MM SOUND 


PATH IN PHONE MIC Sound path for phone 


MM SOUND 


PATH IN EARPHONE MIC Sound path for Earphone mic 


MM SOUND 


PATH IN HFK MIC Sound path for Hands Free Kit mic 


5.5.2.2 enum MMSoundPathType 
Enumerations of audio output path. 


Enumerator: 


MM SOUND 


PATH OUT HFK Sound path for Hands Free Kit 


MM SOUND 


PATH OUT EARPHONE Sound path for Earphone 


MM SOUND 


PATH OUT SPEAKER Sound path for Speaker 


MM SOUND 


PATH OUT RECEIVER Sound path for Receiver 


MM SOUND 


PATH OUT BLUETOOTH Sound path for Bluetooth 


MM SOUND 


PATH IN MIC Sound path for Microphone 


MM SOUND 


PATH IN PHONE MIC Sound path for phone 


MM SOUND 


PATH IN EARPHONE MIC Sound path for Earphone mic 


MM SOUND 


PATH IN HFK MIC Sound path for Hands Free Kit mic 
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MM SOUND PATH OUT HFK Sound path for Hands Free Kit 

MM SOUND PATH OUT EARPHONE Sound path for Earphone 

MM SOUND PATH OUT SPEAKER Sound path for Speaker 

MM SOUND PATH OUT RECEIVER Sound path for Receiver 

MM SOUND PATH OUT BLUETOOTH Sound path for Bluetooth 

MM SOUND PATH IN MIC Sound path for Microphone 

MM SOUND PATH IN PHONE MIC Sound path for phone 

MM SOUND PATH IN EARPHONE MIC Sound path for Earphone mic 
MM SOUND PATH IN HFK MIC Sound path for Hands Free Kit mic 


5.5.3 Function Documentation 
5.5.3.1 int MMSoundGetPath (int * path) 
This function retreives current sound device path. 


Parameters: 


path [out] Current sound device path 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMSoundSetPath 


5.5.3.2 int MMSoundGetVolume (int х vol) 
This function is to retreive volume of sound device. 


Parameters: 


vol [out] Current volume level. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 
Volume range is from MM_VOLUME_LEVEL_MIN to MM VOLUME LEVEL MAX which is de- 
fined in «mm types.h». 

See also: 


MMSoundSetVolume 
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5.5.3.3 іш MMSoundGrabPath (int path, int х grab 14) 


This function is to grab sound device path. 


Parameters: 


path [in] Sound device path to grab. 
grab id [out] Grabbed id of sound path 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMSoundReleasePath 


5.5.3.4 int MMSoundIsMute (bool х mute) 


This function retreives if volume is muted or not. 


Parameters: 


mute [out] TRUE if volume is muted, or FALSE. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMSoundSetMute 


5.5.3.5 int MMSoundReleasePath (int grab 14) 


This function is to release sound device path which is grabbed. 


Parameters: 


grab id [in] Grabbed id of sound device path. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMSoundGrabPath 
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5.5.3.6 int MMSoundSetMute (bool mute) 


This function is to set mute of sound device. 


Parameters: 


mute [in] Mute. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMSoundIsMute 


5.5.3.7 int MMSoundSetPath (int path) 


This function is to set sound device path. 


Parameters: 
path [іп] Sound device path 
Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 


See also: 


MMSoundGetPath 


5.5.3.8 int MMSoundSetVolume (int volume) 


This function is to set volume of sound device. 
Parameters: 
volume [in] Volume level. 


Returns: 


This function returns zero on success, or negative value with error code. 


Remarks: 
Volume range is from MM_VOLUME_LEVEL_MIN to MM_VOLUME_LEVEL_MAX which is de- 
fined in <mm_types.h>. 

See also: 


MMSoundGetVolume 
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61 MMCamcorderElementName Struct Reference 


6.1.1 Detailed Description 


Element name table. 


Note: 


if name is NULL, not supported. 


Data Fields 


* unsigned int prof id 


unsigned int id 


char * name 


unsigned int m prof id 


unsigned int m id 


char x m pName 


6.1.2 Field Documentation 
6.1.2.1 unsigned int. MMCamcorderElementName::prof id 


id of MMCamcorderProfileAttrsID 


6.1.2.2 unsigned int MMCamcorderElementName::id 


id of value id 


6.1.2.3 chars MMCamcorderElementName::name 


gstreamer element name 
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6.1.2.4 unsigned int MMCamcorderElementName::m prof id 


id of MMCamcorderProfileAttrsID 


6.1.2.5 unsigned int. MMCamcorderElementName::m id 


id of value id 


6.1.2.6 сһагя MMCamcorderElementName::m, pName 


gstreamer element name 


The documentation for this struct was generated from the following files: 


• mm camcorder.cpp 
* mm camcorder.c 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


6.2 MMMessageType Union Reference 


95 


6.2 MMMessageType Union Reference 


#include «mm message.h» 


6.2.1 Detailed Description 


This structure defines message parameter. 


Data Fields 
* int code 
* struct { 
int total 
int elapsed 
} time 
* struct { 
int previous 
int current 
} state 
* struct { 
int total 
int elapsed 
} time 
* struct { 
int previous 


int current 
} state 


6.2.2 Field Documentation 
6.2.21 int MMMessageType::code 


ММ MESSAGE ERROR, ММ MESSAGE WARNING message parameter code. 


6.2.2.2 іш MMMessageType::total 


Total time. 


6.2.2.3 int MMMessageType::elapsed 


Elapsed time. 


6.2.2.4 struct ( ... } MMMessageType::time 


MM, MESSAGE TIME ELAPSED message parameter structure. 
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6.2.2.5 int MMMessageType::previous 


Previous state. 


6.2.2.6 int MMMessageType::current 


Current state. 


6.2.2.7 struct { ... } MMMessageType::state 


MM, MESSAGE STATE CHANGED message parameter structure. 


6.2.2.8 struct ( ... } MMMessageType::time 


MM, MESSAGE TIME ELAPSED message parameter structure. 


6.2.2.9 struct ( ... } MMMessageType::state 


MM, MESSAGE STATE CHANGED message parameter structure. 


The documentation for this union was generated from the following files: 


* AVFramework/common/mm, message.h 
* GStreamerFramework/common/mm message.h 
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6.3 MMPlayerVolumeType Struct Reference 


#include «mm player.h» 


6.3.1 Detailed Description 


Volume type. 
See also: 


MMPlayerSetVolume MMPlayerGetVolume 


Data Fields 


* int level [MM VOLUME CHANNEL МОМ] 


6.3.2 Field Documentation 
6.3.2.1 int MMPlayerVolumeType::level 


Relative volume level for each channels 


The documentation for this struct was generated from the following files: 


* AVFramework/player/mm player.h 
* GStreamerFramework/player/mm player.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


98 


Data Structure Documentation 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


Chapter 7 


File Documentation 


7.1 ComponentOverview.h File Reference 


7.1.4 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 


100 File Documentation 
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8.1 mm camcorder audio example.c 


00001 
00002 
00003 
00004 
00005 
00006 
00007 
00008 
00009 
00010 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 
00044 


оо з су (л ымы 


#include <stdio.h> 
#include <glib.h> 
#include <mm_camcorder.h> 


GMainLoop *g loop; 
GIOChannel xstdin channel; 
int g current state; 


static bool msg callback(int message, 


= 


} 


MMHandleType camcorder; 


switch (message) { 


MMMessageType param, 


= $d\n", param-»code); 


case | MESSAGE_ERROR: 
printf("MM MESSAGE ERROR : code 
break; 
case | MESSAGE WARNING: 
printf("MM MESSAGE WARNING : code = %d\n", 
break; 
case MESSAGE OUT OF LIMIT: 


printf("MM MESSAGE OUT OF LIMIT 
а main loop quit (g loop); 
break; 


case MM MESSAGE TIME ELAPSED: 
printf("MM MESSAGE TIME ELAPSED 
break; 


case MM MESSAGE STATE CHANGED: 
g current state = param->state. 


printf("MM MESSAGE STATE CHANGED 


break; 


default: 
break; 


return TRUE; 


static void menu (void) 


{ 


ргіпЕЕ("Хе----------------------------- 


void »user, param) 


param-»code); 


(reached to limit size)\n"); 


(elapsed 


current; 


(current state 


$d sec) \n", 


param-»time.elapsed / 1000); 


ѕа) \п", g current state); 


102 Example Documentation 


00045 ОЕЕО '0' show Menu.\n"); 

00046 print£f("Xc "1° Start Recording. Mn"); 
00047 prinkf("Xt '2' Pause Recording. Nn"); 
00048 printf("Nt 'e' Save & Exit.\n"); 

00049 printf ("\t=============================\N")} 
00050 } 

00051 

00052 static gboolean cmd_input (GIOChannel xchannel) 
00053 ( 

00054 gchar buf[256]; 

00055 gsize read; 

00056 int err; 

00057 

00058 g io channel read(channel, buf, 256, &read); 
00059 buf[read] = ’\0'; 

00060 а strstrip (buf); 

00061 

00062 switch (buf[0]) ( 

00063 case '0': 

00064 menu(); 

00065 break; 

00066 case '1': //rec start 

00067 //start 

00068 printf ("*Start!\n"); 

00069 err = MMCamcorderRecord(camcorder) ; 
00070 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00071 break; 

00072 case '2': //rec pause 

00073 //pause 

00074 printf("xPause!Mn"); 

00075 err = MMCamcorderPause (camcorder); 
00076 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00077 break; 

00078 case 'e': //commit & end 

00079 /* commit camcorder */ 

00080 printf ("*Save!\n"); 

00081 err = MMCamcorderCommit (camcorder); 
00082 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00083 /* destroy camcorder x/ 

00084 printf ("*Exit!\n"); 

00085 

00086 // Destroy camcoder 

00087 err = MMCamcorderDestroy (camcorder) ; 
00088 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00089 g_main_loop_quit (g_loop) ; 

00090 break; 

00091 } 

00092 

00093 return TRUE; 

00094 } 

00095 

00096 int main(int argc, char ххагду) 

00097 { 

00098 MMHandleType attrs; 

00099 int err; 

00100 

00101 stdin_channel = g_io_channel_unix_new (0); 
00102 g io add watch (stdin channel, G IO IN, (GIOFunc)cmd_input, NULL); 
00103 

00104 g loop = g main loop new(NULL, FALSE); 

00105 

00106 err = MMCamcorderCreate (&camcorder); 

00107 

00108 if (err < 0) { 

00109 fprintf(stderr, "error = %d\n", err); 
00110 goto error; 

00111 } 
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00112 

00113 MMCamcorderSetMessageCallback (camcorder, msg callback, NULL); 

00114 

00115 /* profile attribute setting x/ 

00116 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR PROFILE, &attrs); 
00117 

00118 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE MODE, MM CAMCORDER, MODE, AUDIO); 
00119 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE AUDIO DEVICE, MM AUDIO DEVICE MIC); 
00120 MMAttrsSetString(attrs, MM CAMCORDER PROFILE AUDIO CODEC, "AMR", 4); 
00121 MMAttrsSetString(attrs, MM CAMCORDER PROFILE FILE FORMAT, "amrformat", 10); 
00122 

00123 err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR PROFILE, attrs); 
00124 

00125 if (err < 0) f 

00126 fprintf(stderr, "error = %d\n", err); 

00127 goto error; 

00128 } 

00129 

00130 /* audio source attribute setting */ 

00131 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR AUDIO SOURCE, &attrs); 
00132 

00133 MMAttrsSetInt (attrs, MM CAMCORDER AUDIO SOURCE SAMPLERATE, 8000); 

00134 MMAttrsSetInt(attrs, MM CAMCORDER AUDIO SOURCE FORMAT, 16); 

00135 MMAttrsSetInt(attrs, MM CAMCORDER AUDIO SOURCE CHANNEL, 1); 

00136 

00137 err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR AUDIO SOURCE, attrs); 
00138 

00139 if (err « 0) ( 

00140 fprintf(stderr, "error = %d\n", err); 

00141 goto error; 

00142 } 

00143 

00144 /ж target attribute setting «/ 

00145 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR TARGET, &attrs); 

00146 

00147 MMAttrsSetString(attrs, MM CAMCORDER TARGET FILENAME, "./audio.amr", 12); 
00148 

00149 err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR TARGET, attrs); 
0015 

00151 if (err « 0) ( 

00152 fprintf(stderr, "error = %d\n", err); 

00153 goto error; 

00154 } 

00155 

00156 

00157 err = MMCamcorderRealize (camcorder) ; 

00158 if (err < 0) { 

00159 fprintf(stderr, "error = %d\n", err); 

00160 goto error; 

00161 } 

00162 

00163 /* start camcorder x/ 

00164 err - MMCamcorderStart (camcorder); 

00165 if (err < 0) { 

00166 fprintf(stderr, "error = %d\n", err); 

00167 goto error; 

00168 } 

00169 

00170 menu (); 

00171 

00172 g main loop run(g loop); 

00173 

00174 return 0; 

00175 

00176 error: 

00177 if (camcorder != 0) 

00178 { 
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00179 
00180 
00181 
00182 
00183 
00184 


// Destroy camcoder 
MMCamcorderDestroy (camcorder); 


return -1; 
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8.2 mm camcorder image example.c 


00001 #include <stdio.h> 

00002 #include <glib.h> 

00003 #include <mm_camcorder.h> 
00004 

00005 GMainLoop жа loop; 

00006 MMHandleType camcorder; 
00007 GIOChannel xstdin channel; 


00008 int g current state; 

00009 

00010 static bool msg callback(int message, MMMessageType «рагам, void хиѕег param) 
00011 ( 

00012 

00013 switch (message) { 

00014 case | MESSAGE_ERROR: 

00015 g_print ("MM_MESSAGE_ERROR : code = %d\n", param-»code); 
00016 break; 

00017 

00018 case | MESSAGE_WARNING: 

00019 g print("MM MESSAGE WARNING : code = %d\n", param-»code); 
00020 break; 

00021 

00022 case MESSAGE OUT OF LIMIT: 

00023 а print("MM MESSAGE OUT OF LIMIT(reached to limit size) Nn"); 
00024 g main loop quit (g loop); 

00025 break; 

00026 

00027 case MM MESSAGE STATE CHANGED: 

00028 g current state - param-»state.current; 
00029 а print("MM MESSAGE STATE CHANGED (current state : %d)\n", а current state); 
00030 break; 

00031 

00032 default: 

00033 break; 

00034 ) 

00035 

00036 return TRUE; 

00037 } 

00038 

00039 static void menu(void) 

00040 ( 

00041 printf ("\t=============================\N")} 
00042 Prine oA "0” show Menu.\n"); 

00043 printf("Nt ‘1’ Capture(Still-shot).n"); 
00044 printf("Nt '2' Capture (Multi-shot).\n"); 
00045 print£("Xt 'c' Cancel Capturing.\n"); 

00046 релт АЖ 'e' Exit.\n"); 

00047 printf ("\t=============================\N")} 
00048 } 

00049 

00050 static gboolean cmd input (GIOChannel хсһаппе1) 
00051 ( 

00052 gchar buf[256]; 

00053 gsize read; 

00054 int err; 

00055 

00056 g io channel read(channel, buf, 256, &read); 
00057 buf[read] = 'N0'; 

00058 а strstrip (buf); 

00059 

00060 switch (buf[0]) { 

00061 case '0*: 

00062 menu(); 

00063 break; 

00064 case '1': //stillshot 

00065 { 
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00066 printf("*Still-shot Capture! Win"); 

00067 //setting 

00068 MMHandleType attrs; 

00069 

00070 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR CAPTURE, &attrs); 
00071 

00072 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE WIDTH, 176); 

00073 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE HEIGHT, 144); 

00074 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE COUNT, 1); //shot count == 1 
00075 

00076 MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR CAPTURE, attrs); 
00077 

00078 //capture 

00079 err = MMCamcorderCaptureStart (camcorder); 

00080 } 

00081 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 

00082 break; 

00083 case '2': //multishot 

00084 { 

00085 printf("xMulti-shot Capture!\n"); 

00086 //setting. 

00087 MMHandleType attrs; 

00088 

00089 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR CAPTURE, &attrs); 
00090 

00091 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE WIDTH, 176); 

00092 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE HEIGHT, 144); 

00093 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE COUNT, 6); //shot count > 1 
00094 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE INTERVAL, 400); //shot interval (mili 
00095 

00096 MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR CAPTURE, attrs); 
00097 

00098 //capture 

00099 err - MMCamcorderCaptureStart (camcorder); 

00100 if (err < 0) { fprintf(stderr, "error = $dWMn", err); } 

00101 } 

00102 break; 

00103 case 'c': //canel capture 

00104 printf("*Cancel Capture! Mn"); 

00105 err = MMCamcorderCaptureStop (camcorder); 

00106 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 

00107 break; 

00108 case 'e': //end 

00109 printf ("*Exit!\n"); 

00110 /* stop camcorder x/ 

00111 err = MMCamcorderStop (camcorder); 

00112 if (err < 0) { fprintf(stderr, "error = $dMn", err); } 

00113 // Free all the string, data & array attributes here 

00114 / /tbd 

00115 

00116 // Destroy camcoder 

00117 err = MMCamcorderDestroy (camcorder); 

00118 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 

00119 g_main_loop_quit (g loop); 

00120 break; 

00121 } 

00122 

00123 return TRUE; 

00124 ] 

00125 

00126 int main(int argc, char ххагду) 

00127 ( 

00128 MMHandleType attrs; 

00129 int err; 

00130 

00131 stdin channel = g io channel unix new (0);/* read from stdin ж/ 

00132 g io add watch (stdin channel, G IO IN, (GIOFunc)cemd input, NULL); 
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00133 

00134 g loop = g main loop new(NULL, FALSE); 

00135 

00136 err = MMCamcorderCreate (&camcorder); 

00137 

00138 if (err « 0) { 

00139 fprintf(stderr, "error = %d\n", err); 

00140 goto error; 

00141 } 

00142 

00143 MMCamcorderSetMessageCallback (camcorder, msg_callback, NULL); 

00144 

00145 /* profile attribute setting »/ 

00146 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR PROFILE, &attrs); 
00147 

00148 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE MODE, MM CAMCORDER, MODE, IMAGE); 
00149 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE VIDEO DEVICE, MM VIDEO DEVICE CAMERAO); 
00150 MMAttrsSetString(attrs, MM CAMCORDER PROFILE IMAGE CODEC, "jpeg", 5); 
00151 

00152 MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR PROFILE, attrs); 

00153 

00154 /* video source attribute setting x/ 

00155 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR VIDEO SOURCE, &attrs); 
00156 

00157 MMAttrsSetInt(attrs, MM CAMCORDER VIDEO SOURCE WIDTH, 176); 

00158 MMAttrsSetInt(attrs, MM CAMCORDER VIDEO SOURCE HEIGHT, 144); 

00159 MMAttrsSetInt(attrs, MM CAMCORDER VIDEO SOURCE FPS, 15); 

00160 

00161 err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR VIDEO SOURCE, attrs); 
00162 

00163 if (err « 0) ( 

00164 fprintf(stderr, "error = %d\n", err); 

00165 goto error; 

00166 } 

00167 

00168 /* image encoder attribute setting */ 

00169 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR IMAGE ENCODER, &attrs); 
00170 

00171 MMAttrsSetInt(attrs, ММ CAMCORDER IMAGE ENCODER QUALITY, 85); 

00172 

00173 err - MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR IMAGE ENCODER, attrs); 
00174 

00175 if (err « 0) { 

00176 fprintf(stderr, "error = %d\n", err); 

00177 goto error; 

00178 } 

00179 

00180 /* capture attribute setting »/ 

00181 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR CAPTURE, &attrs); 
00182 

00183 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE WIDTH, 176); 

00184 MMAttrsSetInt(attrs, MM CAMCORDER CAPTURE HEIGHT, 144); 

00185 MMAttrsSetInt(attrs, ММ CAMCORDER CAPTURE COUNT, 1); 

00186 

00187 err - MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR CAPTURE, attrs); 
00188 

00189 if (err « 0) ( 

00190 fprintf(stderr, "error = %d\n", err); 

00191 goto error; 

00192 } 

00193 

00194 /x target attribute setting «/ 

00195 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR TARGET, &attrs); 

00196 

00197 MMAttrsSetString(attrs, MM CAMCORDER TARGET FILENAME, "./capture.jpg",14); 
00198 

00199 err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR TARGET, attrs); 
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00200 

00201 if (err < 0) { 

00202 fprintf(stderr, "error = %d\n", err); 
00203 goto error; 

00204 } 

00205 

00206 err = MMCamcorderRealize (camcorder); 
00207 if (err < 0) { 

00208 fprintf(stderr, "error = %d\n", err); 
00209 goto error; 

00210 } 

00211 

00212 /* start camcorder x/ 

00213 err - MMCamcorderStart (camcorder); 

00214 

00215 if (err < 0) { 

00216 fprintf(stderr, "error = %d\n", err); 
00217 goto error; 

00218 } 

00219 

00220 menu () ; 

00221 

00222 g_main_loop_run(g_loop); 

00223 

00224 return 0; 

00225 

00226 error: 

00227 if (camcorder != NULL) 

00228 { 

00229 // Free all the string, data & array attributes here 
00230 //tbd 

00231 

00232 // Destroy camcoder 

00233 MMCamcorderDestroy (camcorder) ; 

00234 } 

00235 

00236 return -1; 

00237 } 

00238 


00239 /*EOF«/ 
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8.3 mm camcorder video example.c 


00001 #include <stdio.h> 

00002 #include <glib.h> 

00003 #include <mm_camcorder.h> 
00004 

00005 GMainLoop жа loop; 

00006 MMHandleType camcorder; 
00007 GIOChannel xstdin channel; 


00008 int g current state; 

00009 

00010 static void menu(void) 

00011 { 

00012 printf ("\t=============================\N")} 
00013 printf("Nt "0” show Menu. Mn"); 

00014 printf("Nt "1° Start Recording. Nn"); 
00015 рее ХЕ '2' Pause Recording. Nn"); 
00016 princi" st 'e' Save & Exit.\n"); 

00017 printf ("\t=============================\N")} 
00018 } 

00019 

00020 static gboolean cmd_input (GIOChannel xchannel) 
00021 { 

00022 gchar buf[256]; 

00023 gsize read; 

00024 int err; 

00025 

00026 g io channel read(channel, buf, 256, &read); 
00027 buf[read] = 'VN0'; 

00028 g strstrip (buf); 

00029 

00030 switch( buf[0] 

00031 { 

00032 case '0': 

00033 menu(); 

00034 break; 

00035 case '1': //rec start 

00036 //start 

00037 printf ("*Start!\n"); 

00038 err = MMCamcorderRecord(camcorder) ; 
00039 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00040 break; 

00041 case '2': //rec pause 

00042 //pause 

00043 printf("xPause!Mn"); 

00044 err = MMCamcorderPause (camcorder); 
00045 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00046 break; 

00047 case 'e': //commit & end 

00048 /* commit camcorder */ 

00049 printf ("*Save!\n"); 

00050 err = MMCamcorderCommit (camcorder); 
00051 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00052 // Free all the string, data & array attributes here 
00053 //tbd 

00054 

00055 /* destroy camcorder */ 

00056 printf ("*Exit!\n"); 

00057 err = MMCamcorderDestroy (camcorder) ; 
00058 if (err < 0) { fprintf(stderr, "error = %d\n", err); } 
00059 g_main_loop_quit (g_loop) ; 

00060 break; 

00061 } 

00062 

00063 return TRUE; 

00064 } 

00065 
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00066 static bool msg callback(int message, MMMessageType «param, void хиѕег param) 


00067 ( 

00068 

00069 switch (message) { 

00070 case | MESSAGE, ERROR: 

00071 g print("MM MESSAGE ERROR : code = %d\n", param-»code); 

00072 break; 

00073 

00074 case | MESSAGE WARNING: 

00075 g print("MM MESSAGE WARNING : code = %d\n", param-»code); 

00076 break; 

00077 

00078 case MESSAGE OUT OF LIMIT: 

00079 а. print("MM MESSAGE OUT OF LIMIT(reached to limit size) Nn"); 
00080 g main loop quit (g loop); 

00081 break; 

00082 

00083 case MM MESSAGE TIME ELAPSED: 

00084 а print("MM MESSAGE TIME ELAPSED(elapsed : $d sec)\n", param-»time.elapsed / 1000); 
00085 break; 

00086 

00087 case MM MESSAGE STATE CHANGED: 

00088 g current state - param-»state.current; 

00089 а print("MM MESSAGE STATE CHANGED (current state : %d)\n", а current state); 
00090 break; 

00091 

00092 default: 

00093 break; 

00094 ) 

00095 

00096 return TRUE; 

00097 } 

00098 

00099 int main(int argc, char x*argv) 

00100 ( 

00101 MMHandleType attrs; 

00102 int err; 

00103 

00104 stdin channel = g io channel unix new (0); 

00105 а io add watch (stdin channel, G IO IN, (GIOFunc)cemd input, NULL); 
00106 

00107 g loop = g main loop new(NULL, FALSE); 

00108 

00109 err = MMCamcorderCreate (&camcorder); 

00110 

00111 if (err < 0) { 

00112 fprintf(stderr, "error = %d\n", err); 

00113 goto error; 

00114 } 

00115 

00116 MMCamcorderSetMessageCallback (camcorder, msg callback, NULL); 

00117 

00118 /* profile attribute setting x/ 

00119 MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR PROFILE, &attrs); 

00120 

00121 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE MODE, MM CAMCORDER, MODE, VIDEO); 
00122 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE AUDIO DEVICE, MM AUDIO DEVICE MIC); 
00123 MMAttrsSetInt(attrs, MM CAMCORDER PROFILE VIDEO DEVICE, MM VIDEO DEVICE CAMERAO); 
00124 MMAttrsSetString(attrs, MM CAMCORDER PROFILE AUDIO CODEC, "mp3", 4); 
00125 MMAttrsSetString(attrs, MM CAMCORDER PROFILE VIDEO CODEC, "mpeg", 5); 
00126 MMAttrsSetString(attrs, MM CAMCORDER PROFILE FILE FORMAT, "matroska", 9); 
00127 

00128 err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR PROFILE, attrs); 
00129 

00130 If еш <0) 4 

00131 fprintf(stderr, "error = %d\n", err); 

00132 goto error; 
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/* audio source attribute setting x/ 
MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR AUDIO SOURCE, &attrs); 


MMAttrsSetInt(attrs, MM CAMCORDER AUDIO SOURCE SAMPLERATE, 44100); 
MMAttrsSetInt(attrs, MM CAMCORDER AUDIO SOURCE FORMAT, 16); 
MMAttrsSetInt(attrs, MM CAMCORDER AUDIO SOURCE CHANNEL, 2); 


err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR AUDIO SOURCE, attrs); 
if (err « 0) ( 


fprintf(stderr, "error = %d\n", err); 
goto error; 


/* video source attribute setting x/ 

MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR VIDEO SOURCE, &attrs); 
MMAttrsSetInt(attrs, MM CAMCORDER VIDEO SOURCE WIDTH, 176); 
MMAttrsSetInt(attrs, ММ CAMCORDER VIDEO SOURCE HEIGHT, 144); 
MMAttrsSetInt(attrs, MM CAMCORDER VIDEO SOURCE FPS, 15); 

err = MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR VIDEO SOURCE, attrs); 
if (err < 0) { 


fprintf(stderr, "error = %d\n", err); 
goto error; 


/ж target attribute setting «/ 
MMCamcorderGetAttrs (camcorder, MM CAMCORDER ATTR TARGET, &attrs); 
MMAttrsSetString(attrs, MM CAMCORDER TARGET FILENAME, "./av.mkv", 9); 
err - MMCamcorderSetAttrs (camcorder, MM CAMCORDER ATTR TARGET, attrs); 
if (err < 0) { 
fprintf(stderr, "error = %d\n", err); 
goto error; 
err = MMCamcorderRealize (camcorder) ; 
if (err < 0) { 


fprintf(stderr, "error = %d\n", err); 
goto error; 


/* start camcorder x/ 
err = MMCamcorderStart (camcorder) ; 


if (err < 0) { 
fprintf(stderr, "error = %d\n", err); 
goto error; 


menu (); 


а main loop run(g 1оор); 


return 0; 


error: 


if (camcorder != 0) 
{ 
// Free all the string, data & array attributes here 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


Example Documentation 


//tbd 
// Destroy camcoder 
MMCamcorderDestroy (camcorder); 


} 


return -1; 
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8.4 mm image example.c 


00001 #include "mm image.h" 
00002 
00003 
00004 
00005 
00006 
00007 
00008 
00009 


000 


000 


LO 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
19 


о чо (л BWN FS 


00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 ] 


int main () 


{ 


ММ 
MM 
in 


4а” 
/ж 
ММ 
а” 


4.” 
/ж 


HandleType attrs; 
HandleType image; 
t err; 


print ("Entering MMImageCreateFromFile\n") ; 

Decoding */ 

ImageCreateFromFile (&image, "/mnt/hgfs/crap/TestApps/test.png"); 
print ("Leaving MMImageCreateFromFile Nn"); 


_print ("Entering MMImageGetAttrs Nn"); 


Encoding x/ 
ImageGetAttrs (image, MM IMAGE ATTRS CODEC, &attrs); 


_print ("Leaving MMImageGetAttrs Nn"); 


print ("Entering MMAttrsSetInt\n"); 
Set jpeg-quality »*/ 


MMAttrsSetInt(attrs, MM IMAGE CODEC QUALITY, 75); 


9g. 


MM 
9 


ге 


print ("Leaving MMAttrsSetInt in"); 


_print ("Entering MMImageSetAttrs Nn"); 


r = MMImageSetAttrs(image, MM IMAGE ATTRS CODEC, attrs); 


_print ("Leaving MMImageSetAttrs Nn"); 


_print ("Entering MMImageEncodeToFile\n"); 


Encode to file «/ 
ImageEncodeToFile(image, "/mnt/hgfs/crap/TestApps/new_image. jpg"); 


_print ("Leaving MMImageEncodeToFile\n") ; 


_print ("Entering MMImageDestroy\n") ; 


ImageDestroy (image) ; 
print ("Leaving MMImageDestroy\n") ; 


turn 0; 
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00001 #include «glib.h» 

00002 #include <gdk/gdkx.h> 

00003 #include <gtk/gtk.h> 

00004 #include <mm_player.h> 

00005 #include <string.h> 

00006 

00007 enum { 

00008 CURRENT STATUS MAINMENU = 0, 

00009 CURRENT_STATUS_FILENAME = 1, 

00010 CURRENT_STATUS_VOLUME = 2, 

00011 CURRENT_STATUS_POSITION = 3, 

00012 }; 

00013 

00014 GMainLoop жа 1оор; 

00015 іпе а current state; 

00016 int g menu state - CURRENT STATUS MAINMENU; 
00017 MMHandleType g player = 0; 

00018 XID g video xid = 0; 

00019 

00020 #define MAX STRING LEN 255 

00021 

00022 void freeattrs() 

00023 ( 

00024 MMHandleType attrs = 0; 

00025 char *string = NULL; 

00026 void *xdata = NULL; 

00027 int size; 

00028 int «array = NULL; 

00029 int count; 

00030 

00031 /ж Get player configuration «/ 

00032 MMPlayerGetAttrs(g player, MM PLAYER ATTRS PROFILE, &attrs ); 
00033 if (attrs) 

00034 { 

00035 

00036 MMAttrsGetString(attrs, MM PLAYER PROFILE URI, &string, &size); 
00037 if (string) 

00038 { 

00039 free(string); 

00040 string = NULL; 

00041 } 

00042 

00043 MMAttrsGetData(attrs, MM PLAYER PROFILE PARAM, &data, &size); 
00044 if (data) 

00045 { 

00046 free (data); 

00047 data = NULL; 

00048 } 

00049 attrs = 0; 

00050 } 

00051 

00052 /ж MM PLAYER ATTRS CONTENT*x/ 

00053 MMPlayerGetAttrs(g player, MM PLAYER ATTRS CONTENT, &attrs ); 
00054 if (attrs) 

00055 { 

00056 

00057 MMAttrsGetString(attrs, MM PLAYER CONTENT VIDEO CODEC, &string, &size); 
00058 if (string) 

00059 { 

00060 free (string); 

00061 string = NULL; 

00062 } 

00063 

00064 MMAttrsGetString(attrs, MM PLAYER CONTENT AUDIO CODEC, &string, &size); 
00065 if (string) 
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00066 { 

00067 free(string); 

00068 string = NULL; 

00069 } 

00070 attrs = 0; 

00071 } 

00072 

00073 

00074 /ж MM PLAYER ATTRS ТАбх/ 

00075 MMPlayerGetAttrs(g player, MM PLAYER ATTRS TAG, &attrs ); 

00076 if (attrs) 

00077 { 

00078 

00079 MMAttrsGetString(attrs, MM PLAYER TAG ARTIST, &string, &size); 
00080 if (string) 

00081 ( 

00082 free(string); 

00083 string = NULL; 

00084 } 

00085 

00086 MMAttrsGetString(attrs, MM PLAYER TAG TITLE, &string, &size); 
00087 if (string) 

00088 { 

00089 free (string); 

00090 string = NULL; 

00091 } 

00092 

00093 MMAttrsGetString(attrs, MM PLAYER TAG ALBUM, &string, &size); 
00094 if (string) 

00095 { 

00096 free (string); 

00097 string = NULL; 

00098 } 

00099 

00100 MMAttrsGetString(attrs, MM PLAYER TAG GENRE, &string, &size); 
00101 if (string) 

00102 ( 

00103 free(string); 

00104 string = NULL; 

00105 } 

00106 

00107 MMAttrsGetString(attrs, MM PLAYER TAG AUTHOR, &string, &size); 
00108 if (string) 

00109 { 

00110 free(string); 

00111 string = NULL; 

00112 ) 

00113 

00114 MMAttrsGetString(attrs, MM PLAYER TAG COPYRIGHT, &string, &size); 
00115 if (string) 

00116 { 

00117 free (string); 

00118 string = NULL; 

00119 } 

00120 

00121 MMAttrsGetString(attrs, MM PLAYER TAG DATE, &string, &size); 
00122 if (string) 

00123 ( 

00124 free(string); 

00125 string = NULL; 

00126 } 

00127 

00128 MMAttrsGetString(attrs, MM PLAYER TAG DESCRIPTION, &string, &size); 
00129 if (string) 

00130 { 

00131 free(string); 

00132 string = NULL; 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


Example Documentation 


= Еч [M m Гэ um y = = 
© хо о ы ол QM Pd 


= 
aon (л 
о № pP 


anon 
YHA USA 


nw (л 
O «o со 


оу 
Ез 


162 


Е: 
Су OV ОУ ОУ ОУ ОУ ОУ 
о со м OY (л 5 CO 


мч ы ы ы 
C) NN но 


NNN 
с ол 


NNN 
хо oO ы 


180 
1 


со со со 
о М + 


со со со со 
чс UA 


/* Get player configuration x/ 

MMPlayerGetAttrs(g player, MM PLAYER ATTRS DISPLAY, &attrs ); 
if (attrs) 

{ 


MMAttrsGetData(attrs, MM PLAYER DISPLAY DEVICE, &data, &size); 
if (data) 
{ 


free(data); 
data = NULL; 


MMAttrsGetArray(attrs, MM PLAYER DISPLAY ROTATION, &array, &count); 
if (array) 


( 


free(array); 
array = NULL; 
} 
attrs = 0; 


} 


static bool msg callback(int message, MMMessageType *param, void *user_param) 


{ 
switch (message) { 
case | MESSAGE ERROR: 


// g print("error : code = %d\n", param-»code); 
break; 


case | MESSAGE WARNING: 


// g_print ("warning : code = %d\n", param-»code); 
break; 


case | MESSAGE_TIME_ELAPSED: 


// g_print ("elapsed : $d sec\n", param-»5time.elapsed); 
break; 


case MESSAGE_END_OF_STREAM: 
print ("епа of stream\n"); 
PlayerUnrealize(g player); 
reeattrs(); 
PlayerDestroy (g player); 

| player = 0; 

reak; 


Q 


ghg 


o Q 


pase MESSAGE_STATE_CHANGED: 
g current state = param->state.current; 
g print("current state : $dMn", g current state); 
break; 


default: 
return FALSE; 


return TRUE; 
} 


static void input filename(char xfilename) 
{ 


int len = strlen(filename); 
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00200 int size; 

00201 int err = 0; 

00202 

00203 if (len » 0 && len « MAX STRING LEN) ( 

00204 MMHandleType prof prop, dis prop; 

00205 

00206 MMPlayerUnrealize (g player); 

00207 freeattrs(); 

00208 MMPlayerDestroy (g player); 

00209 g player = 0; 

00210 

00211 MMPlayerCreate(&g player); 

00212 MMPlayerSetMessageCallback(g player, msg callback, (void*)g player); 
00213 

00214 /ж set player configuration x/ 

00215 MMPlayerGetAttrs(g player, MM PLAYER ATTRS PROFILE, &prof prop); 
00216 

00217 size = strlen(filename);3 

00218 MMAttrsSetString(prof prop, MM PLAYER PROFILE URI, filename, size); 
00219 MMAttrsSetInt(prof prop, MM PLAYER PROFILE PRIORITY, 0); 

00220 MMAttrsSetData(prof prop, MM PLAYER PROFILE PARAM, (void*)g player, 
00221 

00222 MMPlayerSetAttrs(g player, MM PLAYER ATTRS PROFILE, prof prop); 
00223 

00224 MMPlayerGetAttrs(g player, MM PLAYER ATTRS DISPLAY, &dis prop); 
00225 MMAttrsSetData(dis prop, MM PLAYER DISPLAY DEVICE, (void») (&g video xig), 
00226 MMPlayerSetAttrs(g player, MM PLAYER ATTRS DISPLAY, dis prop); 
00227 

00228 err = MMPlayerRealize(g player); 

00229 

00230 if(lerr) 

00231 { 

00232 /* wait until realized x/ 

00233 while (g current state !- MM PLAYER STATE READY) { 

00234 2 

00235 } 

00236 } 

00237 } 

00238 } 

00239 

00240 static void set volume(int volume) 

00241 ( 

00242 MMPlayerVolumeType volume val = (0,); 

00243 anit, Ар 

00244 

00245 for (i = 0; i < MM VOLUME CHANNEL NUM; i++) { 

00246 volume val.level[i] = volume; 

00247 } 

00248 

00249 MMPlayerSetVolume(g player, &volume val); 

00250 } 

00251 

00252 static void get volume () 

00253 ( 

00254 MMPlayerVolumeType volume = {0,}; 

00255 int i; 

00256 

00257 MMPlayerGetVolume (g player, &volume); 

00258 

00259 g print("[ volume ]\n"); 

00260 for (i = 0; i < MM VOLUME CHANNEL NUM; i++) { 

00261 g print(" channel [%d] = %d\n", i, volume.level[i]); 

00262 ) 

00263 } 

00264 

00265 static void player. play() 

00266 ( 


sizeof(g player)); 


sizeof(&g video xi 
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int bRet = FALSE; 
bRet = MMPlayerStart (g player); 


printf("$s ret:%d\n", _ FUNCTION , bRet); 
} 


static void player stop() 
{ 
int bRet = FALSE; 


bRet = MMPlayerStop(g player); 


printf("$s ret:%d\n", _ FUNCTION , bRet); 
} 


static void player resume() 
{ 
int bRet = FALSE; 


bRet - MMPlayerResume (g player); 


printf("$s ret:%d\n", | FUNCTION , bRet); 
} 


static void player pause() 
{ 
int bRet = FALSE; 


bRet - MMPlayerPause (g player); 


printf("$s ret:%d\n", _ FUNCTION , bRet); 
} 


Static void get position() 
{ 
MMPlayerPosFormatType format = MM PLAYER POS FORMAT TIME; 


int position; 
int error = 0; 


error - MMPlayerGetPosition(g player, format, &position); 


if (!error) { 
g print ("розу $ldWn", position); 


} 
static void set_position(int position) 


{ 
MMPlayerPosFormatType format = MM PLAYER POS FORMAT TIME; 


MMPlayerSetPosition(g player, format, position); 
} 


static void print info() 

{ 
MMHandleType tag prop = 0; 
MMHandleType content prop = 0; 
char *xstring;3 
int size = 0; 
int tracknum - 0; 


/* set player configuration ж/ 
MMPlayerGetAttrs(g player, MM PLAYER ATTRS TAG, &tag prop 
if (tag prop == 0) 

return; 


); 
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00334 

00335 MMAttrsGetString(tag prop, MM PLAYER TAG ARTIST, &string, &size); 
00336 printf("artist: %s\n", string); 

00337 

00338 MMAttrsGetString(tag prop, MM PLAYER TAG TITLE, &string, &size); 
00339 printf("title: %s\n", string); 

00340 

00341 MMAttrsGetString(tag prop, MM PLAYER TAG ALBUM, &string, &size); 
00342 printf("album: %s\n", string); 

00343 

00344 MMAttrsGetString(tag prop, MM PLAYER TAG GENRE, &string, &size); 
00345 printf("genre: %s\n", string); 

00346 

00347 // printf("author: %5\п", MMAttrsGetString(tag prop, MM PLAYER TAG AUTHOR)); 
00348 

00349 MMAttrsGetString(tag prop, MM PLAYER TAG COPYRIGHT, &string, &size); 
00350 printf("copyright: %s\n", string); 

00351 

00352 MMAttrsGetString(tag prop, MM PLAYER TAG DATE, &string, &size); 
00353 printf("date: $sWMn", string); 

00354 

00355 MMAttrsGetString(tag prop, MM PLAYER TAG DESCRIPTION, &string, &size); 
00356 printf("description: %s\n", string); 

00357 

00358 MMAttrsGetInt(tag prop, MM PLAYER TAG TRACK NUM, &tracknum) ; 
00359 printf("track num: %d\n", tracknum); 

00360 

00361 

00362 MMPlayerGetAttrs(g player, MM PLAYER ATTRS CONTENT, &content prop); 
00363 if (content prop -- 0) 

00364 return; 

00365 

00366 MMAttrsGetString(content prop, MM PLAYER CONTENT AUDIO CODEC, &string, &size); 
00367 printf("audio codec: %s\n", string); 

00368 

00369 MMAttrsGetString(content prop, MM PLAYER CONTENT VIDEO CODEC, &string, &size); 
00370 printf("video codec: %s\n", string); 

00371 

00372 

00373 } 

00374 

00375 static void quit program() 

00376 ( 

00377 а print("exit program\n") ; 

00378 MMPlayerUnrealize(g player); 

00379 freeattrs(); 

00380 MMPlayerDestroy (g player); 

00381 g player = 0; 

00382 g main loop quit(g loop); 

00383 } 

00384 

00385 static void displaymenu() 

00386 ( 

00387 а print("Xn"); 

00388 g_print ("**Limo АРІ Test n"); 

00389 if (g menu state == CURRENT STATUS MAINMENU) { 

00390 g_print ("**a. Initialize Median"); 

00391 g_print ("**b. Play\n"); 

00392 g print ("*«c, StopXn"); 

00393 g_print ("**d. Resume\n") ; 

00394 g_print ("**e. Pause\n"); 

00395 g_print ("**f. Set Volume\n"); 

00396 g_print ("**g. Get Volume\n"); 

00397 g_print ("**h. Set Position\n"); 

00398 g_print ("**i. Get Position\n"); 

00399 g_print ("**j. Print Information\n") ; 

00400 g_print ("**q. Quit Program\n") ; 
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else ( 
g_print ("*** unknown status. Mn"); 
quit program(); 


gd print" 2x» m); 


gboolean timeout menu display(void*» data) 
{ 

displaymenu(); 

return FALSE; 


static void interpret (char хспа) 
{ 
switch 


{ 
case CURRENT STATUS MAINMENU: 


(g menu state) 


g_print ("*** input position value.\n"); 


else if (g_menu_state == CURRENT_STATUS_FILENAME) { 
g_print ("*** input mediapath.\n"); 

else if (g_menu_state == CURRENT_STATUS_VOLUME) { 
g_print ("*** input volume value.\n"); 

else if (g_menu_state == CURRENT_STATUS_POSITION) { 


if (strncmp (cmd, "a", 1) == 0) { 
g_menu_state = CURRENT_STATUS_FILENAME; 

) else if (strncmp(cmd, "b", 1) == 0) 
player play(); 

) else if (strncmp (cmd, "c", ) == 0) 
player stop(); 

) else if (ѕігпстр (спа, "d", ) == 0) 
player resume(); 

) else if (strncmp (cmd, "e", ) == 0) 
player pause(); 

} else if (strncmp(cmd, "f", 1) == 0) 
g menu state = CURRENT STATUS VOLUME; 

) else if (strncmp(cmd, "g", 1) == 0) 
get volume(); 

) else if (strncmp (cmd, "h", ) == 0) 
g menu state = CURRENT STATUS POSITION; 

) else if (strncmp(cmd, "i", 1) == 0) 
get position(); 

) else if (strncmp (cmd, "j", 1) == 0) 
print info(); 

) else if (strnomp(cmd, "а", ) == 0) 
quit program(); 

) eise { 
g_print ("unknown menu\n") ; 

} 

break; 


case CURRENT STATUS FILENAME: 
input, filename (cmd); 
g menu state - 
break; 


case CURRENT STATUS VOLUME: 
{ 
gdouble volume = atoi (cmd); 
set volume (volume); 
} 
g menu state = 
break; 


case CURRENT STATUS POSITION: 
{ 


unsigned long position = 


CURRENT STATUS MAINMENU; 


CURRENT STATUS MAINMENU; 


atol (cmd) ; 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


8.5 mm player example.c 121 


004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
005 
005 
005 
005 
005 
005 
005 
005 
005 
005 
005 


0051 
0051 
0051 
0051 


005 
005 


0051 
0051 


68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
00 
01 
02 
03 
04 
05 
06 
07 
08 
09 
10 


i 


1 
2 
3 
4 
15 
6 
j 
8 


set position(position); 
} 
g menu state = CURRENT STATUS MAINMENU; 
break; 


g timeout add(100, timeout menu display, 0); 


gboolean input (GIOChannel хсһаппе1) 


{ 


char buf[MAX STRING LEN + 3]; 
gsize read; 


g io channel read(channel, buf, MAX STRING LEN, &read); 
buf[read] = ’\0'; 

g_strstrip (buf); 

interpret (buf); 

return TRUE; 


void disturb closing video window(GtkWindow *video_window, gpointer data) 


{ 


printf("$sWMn", __FUNCTION__); 


int main(int argc, char xargv[]) 


{ 


GtkWidget жу1ідео area; 
GIOChannel xstdin channel; 


gtk init(&argc, &argv); 


stdin channel = g io channel unix new(0); 
g io add watch(stdin channel, G IO IN, (GIOFunc)input, NULL); 


video area = gtk window new(GTK WINDOW TOPLEVEL); 
g signal connect (СТК OBJECT(video area), "destroy", СТК SIGNAL FUNC (disturb closing video window 
gtk widget show(video area); 


g video xid = GDK WINDOW XWINDOW (СТҚ WIDGET (video, area)-»window); 
displaymenu(); 
g loop = g main loop new(NULL, FALSE); 


а main loop run(g 100p); 


return 0; 
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00001 #include «mm sound.h» 
00002 
00003 static void play sound() 


00004 ( 


00005 


00006 ] 


00007 
00008 int main(int argc, char *argv[]) 


00009 ( 
LO 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
19 


000 


000 


со ы суль с юе 


00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 


00037 ] 


/* TODO: Play sound using player АРТ x/ 


int err; 

int level; 
int path; 
int grab іа; 


/ж set volume level to half «/ 
err = MMSoundGetVolume (&level); 
level /= 2; 

err = MMSoundSetVolume (level); 


play. sound(); 


/* change sound path x/ 

err = MMSoundGetPath(&path); 

path |= MM SOUND PATH OUT RECEIVER; 
err = MMSoundSetPath (path); 


play. sound(); 


/ж grab/release sound path »/ 


err = MMSoundGrabPath (MM SOUND PATH OUT EARPHONE, &grab id); 


play sound(); 
err - MMSoundReleasePath(grab id); 


return 0; 
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